feat(sdk)!: drop the #[fai_module] alias — #[chain_module] only

No module outside this workspace was ever published against the
alias (the system has no external users yet), so the pre-rename
name goes away instead of being maintained: one attribute, no
legacy surface. All internal doc references swept; echo example
description moves to the product name. 0.3.0.

Signed-off-by: flemming-it <sf@flemming.it>

Cargo.lock

@@ -43,7 +43,7 @@ checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
 
 [[package]]
 name = "chain-module-sdk"
-version = "0.2.1"
+version = "0.3.0"
 dependencies = [
  "chain-module-sdk-macros",
  "serde",
@@ -55,7 +55,7 @@ dependencies = [
 
 [[package]]
 name = "chain-module-sdk-macros"
-version = "0.2.1"
+version = "0.3.0"
 dependencies = [
  "proc-macro2",
  "quote",

Cargo.toml

@@ -6,7 +6,7 @@ members = [
 ]
 
 [workspace.package]
-version = "0.2.1"
+version = "0.3.0"
 edition = "2024"
 authors = ["Dr. Stefan Flemming <chain@flemming.ai>"]
 license = "Apache-2.0"

crates/chain-module-sdk-macros/src/lib.rs

@@ -1,7 +1,6 @@
 //! Procedural macros powering `chain-module-sdk`.
 //!
-//! This crate exists only to host the `#[chain_module]` attribute
+//! This crate exists only to host the `#[chain_module]` attribute.
-//! (and its legacy alias `#[fai_module]`).
 //! Module authors should depend on `chain-module-sdk` (which
 //! re-exports the macro), not on this crate directly.
 
@@ -28,18 +27,6 @@ const WIT_INLINE: &str = include_str!("../../../wit/world.wit");
 /// anything — only its signature matters.
 #[proc_macro_attribute]
 pub fn chain_module(_attrs: TokenStream, input: TokenStream) -> TokenStream {
-    expand_module(input)
-}
-
-/// Legacy alias for [`chain_module`], kept so modules written
-/// before the product rename keep compiling. New code uses
-/// `#[chain_module]`.
-#[proc_macro_attribute]
-pub fn fai_module(_attrs: TokenStream, input: TokenStream) -> TokenStream {
-    expand_module(input)
-}
-
-fn expand_module(input: TokenStream) -> TokenStream {
     let user_fn = parse_macro_input!(input as ItemFn);
     let user_fn_name = user_fn.sig.ident.clone();
     let wit_literal = WIT_INLINE;

crates/chain-module-sdk/src/context.rs

@@ -1,7 +1,7 @@
 //! Invocation context passed to a module on every call.
 //!
 //! Mirrors the WIT `invocation-context` record. The
-//! `#[fai_module]` macro builds this from the WIT-generated value
+//! `#[chain_module]` macro builds this from the WIT-generated value
 //! before handing it to user code.
 
 #[derive(Debug, Clone, PartialEq, Eq)]

crates/chain-module-sdk/src/host.rs

@@ -1,7 +1,7 @@
 //! Host-callback plumbing for `Context::emit` (WIT 1.1 `emit-event`).
 //!
 //! The WIT host imports (`emit-event`) are only reachable from the
-//! `wit_bindgen`-generated glue inside the `#[fai_module]` expansion,
+//! `wit_bindgen`-generated glue inside the `#[chain_module]` expansion,
 //! which lives in the module crate — not here. So the macro installs a
 //! function pointer that reaches the real host import, and
 //! [`Context::emit`](crate::Context::emit) calls it through this hook.
@@ -18,7 +18,7 @@ thread_local! {
     static EMIT_HOOK: Cell<Option<fn(&str, Payload)>> = const { Cell::new(None) };
 }
 
-/// Install the emit hook. Called by the `#[fai_module]` expansion at
+/// Install the emit hook. Called by the `#[chain_module]` expansion at
 /// the start of each invocation. Not part of the stable public API.
 #[doc(hidden)]
 pub fn __set_emit_hook(f: fn(&str, Payload)) {

crates/chain-module-sdk/src/inputs.rs

@@ -19,7 +19,7 @@ pub struct Inputs {
 
 impl Inputs {
     /// Build directly from a list of `(name, payload)` pairs.
-    /// Used by the `#[fai_module]` macro after WIT conversion.
+    /// Used by the `#[chain_module]` macro after WIT conversion.
     #[doc(hidden)]
     pub fn __from_pairs(items: Vec<(String, Payload)>) -> Self {
         Self { items }

crates/chain-module-sdk/src/lib.rs

@@ -36,7 +36,7 @@ pub use inputs::Inputs;
 pub use outputs::Outputs;
 pub use payload::{BytesValue, FileRef, Payload};
 
-pub use chain_module_sdk_macros::{chain_module, fai_module};
+pub use chain_module_sdk_macros::chain_module;
 
 // Emit-hook plumbing used by the `#[chain_module]` expansion (wasm32)
 // so `Context::emit` reaches the WIT `emit-event` host import.
@@ -49,7 +49,6 @@ pub(crate) use host::emit;
 pub mod prelude {
     pub use super::{
         BytesValue, Context, FileRef, Inputs, ModuleError, Outputs, Payload, chain_module,
-        fai_module,
     };
 }
 

crates/chain-module-sdk/src/outputs.rs

@@ -71,7 +71,7 @@ impl Outputs {
     }
 
     /// Consume the builder into the underlying `(name, payload)` list.
-    /// Used by the `#[fai_module]` macro after WIT conversion.
+    /// Used by the `#[chain_module]` macro after WIT conversion.
     #[doc(hidden)]
     pub fn __into_pairs(self) -> Vec<(String, Payload)> {
         self.items

crates/chain-module-sdk/src/payload.rs

@@ -2,7 +2,7 @@
 //!
 //! The shape is fixed by the v1.0 WIT freeze. Field-by-field
 //! conversion to and from the WIT-generated type happens inside
-//! the `#[fai_module]` macro expansion in the user crate.
+//! the `#[chain_module]` macro expansion in the user crate.
 
 use serde::{Deserialize, Serialize};
 

examples/echo/Cargo.lock

@@ -34,7 +34,7 @@ checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
 
 [[package]]
 name = "chain-module-sdk"
-version = "0.2.0"
+version = "0.2.1"
 dependencies = [
  "chain-module-sdk-macros",
  "serde",
@@ -45,7 +45,7 @@ dependencies = [
 
 [[package]]
 name = "chain-module-sdk-macros"
-version = "0.2.0"
+version = "0.2.1"
 dependencies = [
  "proc-macro2",
  "quote",

examples/echo/Cargo.toml

@@ -10,7 +10,7 @@ version = "0.1.0"
 edition = "2024"
 license = "Apache-2.0"
 publish = false
-description = "Reference module showing the minimum needed to write an F∆I module with chain-module-sdk."
+description = "Reference module showing the minimum needed to write a Ch∆In module with chain-module-sdk."
 
 [lib]
 crate-type = ["cdylib"]

examples/echo/src/lib.rs

@@ -1,4 +1,4 @@
-//! Minimum-viable F∆I module — echoes the first text input.
+//! Minimum-viable Ch∆In module — echoes the first text input.
 //!
 //! Demonstrates the entire authoring surface: a single function
 //! decorated with `#[chain_module]`. No `wit_bindgen`, no

examples/progress/Cargo.lock

@@ -34,7 +34,7 @@ checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
 
 [[package]]
 name = "chain-module-sdk"
-version = "0.2.0"
+version = "0.3.0"
 dependencies = [
  "chain-module-sdk-macros",
  "serde",
@@ -45,7 +45,7 @@ dependencies = [
 
 [[package]]
 name = "chain-module-sdk-macros"
-version = "0.2.0"
+version = "0.3.0"
 dependencies = [
  "proc-macro2",
  "quote",