hexser 0.5.0

Zero-boilerplate hexagonal architecture with graph-based introspection
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

//! CLI tool to export AI context for the current HexGraph.
//!
//! This binary prints a machine-readable JSON representation of the
//! project's architecture to stdout. It requires the `ai` feature.
//! External tools and AI assistants can consume this JSON to propose
//! compliant changes and validate against project constraints.
//!
//! Revision History
//! - 2026-07-21T00:00:00Z @AI: to_json returns HexResult, so propagate with `?` instead of re-wrapping a String error.
//! - 2026-07-20T00:00:00Z @AI: Allow `disallowed_macros` crate-wide in this CLI binary whose sole job is writing JSON to stdout.
//! - 2025-10-06T17:59:00Z @AI: Introduce `hex-ai-export` binary (feature-gated) that prints AIContext as JSON.
//! - 2025-10-06T18:09:00Z @AI: Fix unresolved paths by using `hexser::` crate paths and align return type to HexResult; map JSON errors to Hexserror.

// This is a CLI binary; writing to stdout is its purpose, so `println!` is intentional.
#![allow(clippy::disallowed_macros)]

fn main() -> hexser::HexResult<()> {
  // Build the current architecture graph from the component registry.
  let graph_arc = hexser::HexGraph::current();

  // Build the AI context using the ContextBuilder and serialize to JSON.
  let builder = hexser::ai::ContextBuilder::new(std::sync::Arc::as_ref(&graph_arc));
  let context = builder.build()?;
  let json = context.to_json()?;

  // Print to stdout for downstream tooling.
  std::println!("{json}");
  std::result::Result::Ok(())
}