apcore_cli/
lib.rs

1// apcore-cli — Command-line interface for apcore modules
2// Library root: re-exports all public API items.
3// Protocol spec: FE-01 through FE-10, SEC-01 through SEC-04
4
5pub mod approval;
6pub mod cli;
7pub mod config;
8pub mod discovery;
9pub mod display_helpers;
10pub mod fs_discoverer;
11pub mod init_cmd;
12pub mod output;
13pub mod ref_resolver;
14pub mod schema_parser;
15pub mod security;
16pub mod shell;
17
18// Internal sandbox runner — not part of the public API surface, but must be
19// pub so the binary entry point (main.rs) can invoke run_sandbox_subprocess().
20#[doc(hidden)]
21pub mod _sandbox_runner;
22
23// Exit codes as defined in the API contract.
24pub const EXIT_SUCCESS: i32 = 0;
25pub const EXIT_MODULE_EXECUTE_ERROR: i32 = 1;
26pub const EXIT_INVALID_INPUT: i32 = 2;
27pub const EXIT_MODULE_NOT_FOUND: i32 = 44;
28pub const EXIT_SCHEMA_VALIDATION_ERROR: i32 = 45;
29pub const EXIT_APPROVAL_DENIED: i32 = 46;
30pub const EXIT_CONFIG_NOT_FOUND: i32 = 47;
31pub const EXIT_SCHEMA_CIRCULAR_REF: i32 = 48;
32pub const EXIT_ACL_DENIED: i32 = 77;
33pub const EXIT_SIGINT: i32 = 130;
34
35// Re-export primary public types at crate root.
36pub use approval::{check_approval, ApprovalError};
37pub use cli::{
38    build_module_command, build_module_command_with_limit, collect_input,
39    collect_input_from_reader, get_docs_url, is_verbose_help, set_audit_logger, set_docs_url,
40    set_executables, set_verbose_help, validate_module_id, GroupedModuleGroup, ModuleExecutor,
41};
42pub use config::ConfigResolver;
43pub use discovery::{
44    cmd_describe, cmd_list, register_discovery_commands, ApCoreRegistryProvider, DiscoveryError,
45    RegistryProvider,
46};
47pub use display_helpers::{get_cli_display_fields, get_display};
48pub use init_cmd::{handle_init, init_command};
49// Test utilities — available but hidden from docs.
50// Gated behind cfg(test) for unit tests and the test-support feature for
51// integration tests. Excluded from production builds.
52#[cfg(any(test, feature = "test-support"))]
53#[doc(hidden)]
54pub use discovery::{mock_module, MockRegistry};
55pub use fs_discoverer::FsDiscoverer;
56pub use output::{format_exec_result, format_module_detail, format_module_list, resolve_format};
57pub use ref_resolver::resolve_refs;
58pub use schema_parser::{
59    extract_help_with_limit, reconvert_enum_values, schema_to_clap_args,
60    schema_to_clap_args_with_limit, BoolFlagPair, SchemaArgs, SchemaParserError, HELP_TEXT_MAX_LEN,
61};
62pub use security::{AuditLogger, AuthProvider, ConfigEncryptor, Sandbox};
63pub use shell::{
64    build_program_man_page, build_synopsis, cmd_completion, cmd_man, completion_command,
65    generate_man_page, has_man_flag, register_shell_commands, ShellError, KNOWN_BUILTINS,
66};
apcore_cli/lib.rs

apcore_cli/
lib.rs
