ggen-core 26.5.19

Core graph-aware code generation engine
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

//! Poka-Yoke (Error-Proofing) mechanisms for ggen CLI.
//!
//! This module provides error-proofing mechanisms following DfLSS principles:
//! - Type-level safety (compile-time guarantees)
//! - Zero-cost abstractions (no runtime overhead)
//! - RAII pattern (automatic cleanup)
//! - Fail-fast design (early detection)
//! - Stop-the-Line protocol (Andon signals)
//! - Quality gates (mandatory checkpoints)
//!
//! # Mechanisms
//!
//! 1. [`AtomicFileWriter`] - Atomic file writes with rollback
//! 2. [`ValidatedPath`] - Path traversal prevention
//! 3. [`TimeoutIO`] - SLO-based timeout enforcement
//! 4. [`SanitizedInput`] - Injection prevention
//! 5. [`LockfileGuard`] - Race condition prevention
//! 6. [`NetworkRetry`] - Transient failure handling
//! 7. [`DryRunMode`] - Preview before execution
//! 8. [`AndonSignal`] - Stop-the-Line (RED/YELLOW/GREEN)
//! 9. [`QualityGate`] - Mandatory checkpoints before generation

pub mod andon;
pub mod atomic_writer;
pub mod dry_run;
pub mod lockfile_guard;
pub mod network_retry;
pub mod quality_gates;
pub mod sanitized_input;
pub mod timeout_io;
pub mod validated_path;

// Re-export core types
#[allow(unused_imports)]
pub use andon::{AndonSignal, CriticalError, Warning};
#[allow(unused_imports)]
pub use atomic_writer::{AtomicFileWriter, Committed, Uncommitted};
#[allow(unused_imports)]
pub use dry_run::{DryRunMode, Operation};
pub use lockfile_guard::LockfileGuard;
pub use network_retry::NetworkRetry;
pub use quality_gates::{QualityGate, QualityGateRunner, ValidationCheckpoint};
pub use sanitized_input::{InputType, SanitizedInput};
pub use timeout_io::TimeoutIO;
pub use validated_path::ValidatedPath;

#[cfg(test)]
mod tests;