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;
33// Config Bus errors (apcore >= 0.15.0)
34pub const EXIT_CONFIG_NAMESPACE_RESERVED: i32 = 78;
35pub const EXIT_CONFIG_NAMESPACE_DUPLICATE: i32 = 78;
36pub const EXIT_CONFIG_ENV_PREFIX_CONFLICT: i32 = 78;
37pub const EXIT_CONFIG_MOUNT_ERROR: i32 = 66;
38pub const EXIT_CONFIG_BIND_ERROR: i32 = 65;
39pub const EXIT_ERROR_FORMATTER_DUPLICATE: i32 = 70;
40pub const EXIT_SIGINT: i32 = 130;
41
42// Re-export primary public types at crate root.
43pub use approval::{check_approval, ApprovalError};
44pub use cli::{
45    build_module_command, build_module_command_with_limit, collect_input,
46    collect_input_from_reader, get_docs_url, is_verbose_help, set_audit_logger, set_docs_url,
47    set_executables, set_verbose_help, validate_module_id, GroupedModuleGroup, ModuleExecutor,
48};
49pub use config::ConfigResolver;
50pub use discovery::{
51    cmd_describe, cmd_list, register_discovery_commands, ApCoreRegistryProvider, DiscoveryError,
52    RegistryProvider,
53};
54pub use display_helpers::{get_cli_display_fields, get_display};
55pub use init_cmd::{handle_init, init_command};
56// Test utilities — available but hidden from docs.
57// Gated behind cfg(test) for unit tests and the test-support feature for
58// integration tests. Excluded from production builds.
59#[cfg(any(test, feature = "test-support"))]
60#[doc(hidden)]
61pub use discovery::{mock_module, MockRegistry};
62pub use fs_discoverer::FsDiscoverer;
63pub use output::{format_exec_result, format_module_detail, format_module_list, resolve_format};
64pub use ref_resolver::resolve_refs;
65pub use schema_parser::{
66    extract_help_with_limit, reconvert_enum_values, schema_to_clap_args,
67    schema_to_clap_args_with_limit, BoolFlagPair, SchemaArgs, SchemaParserError, HELP_TEXT_MAX_LEN,
68};
69pub use security::{AuditLogger, AuthProvider, ConfigEncryptor, Sandbox};
70pub use shell::{
71    build_program_man_page, build_synopsis, cmd_completion, cmd_man, completion_command,
72    generate_man_page, has_man_flag, register_shell_commands, ShellError, KNOWN_BUILTINS,
73};
apcore_cli/lib.rs

apcore_cli/
lib.rs
