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
#![cfg_attr(coverage_nightly, coverage(off))]
//! Help Generator - Dynamic --help text from CommandRegistry
//!
//! This module generates accurate help text from the single source of truth
//! (CommandRegistry), ensuring documentation is never out of sync with implementation.
//!
//! # Architecture (Toyota Way - Genchi Genbutsu)
//!
//! ```text
//! CommandRegistry -> HelpGenerator -> Formatted Help Text
//! |-- Terminal output
//! |-- Man pages
//! +-- Markdown docs
//! ```
//!
//! # Module Layout
//!
//! - `help_generator_formatting.rs` - HelpGenerator impl (constructor, generation, formatting)
//! - `help_generator_utils.rs` - Free utility functions (levenshtein, truncate_str)
//! - `help_generator_tests.rs` - Unit tests
//!
//! # References
//!
//! - Specification: docs/specifications/unified-cli-mcp-help-integration.md
//! - GitHub Issue: #118
use crate::cli::registry::{
ArgumentMetadata, CommandMetadata, CommandRegistry, ExecutionTime, ValueType,
};
use std::io::IsTerminal;
/// Generates formatted help text from CommandRegistry.
pub struct HelpGenerator {
registry: CommandRegistry,
color: bool,
width: usize,
}
// --- Include files ---
include!("help_generator_formatting.rs");
include!("help_generator_utils.rs");
include!("help_generator_tests.rs");