apcore-cli 0.8.0 → 0.9.0

package/dist/index.d.ts

@@ -69,6 +69,13 @@ type ApcliConfig = boolean | {
     exclude?: string[];
     disableEnv?: boolean;
 };
+/**
+ * Default name of the built-in command group. Overridable per ApcliGroup
+ * instance via the `name` constructor option, or via createCli's
+ * `builtinGroupName` option. Cross-SDK parity with Python
+ * `DEFAULT_BUILTIN_GROUP_NAME` (2026-05-08).
+ */
+declare const DEFAULT_BUILTIN_GROUP_NAME = "apcli";
 /**
  * Set of group names reserved by apcore-cli when no rename is configured.
  * Default mirrors {@link DEFAULT_BUILTIN_GROUP_NAME}; when `builtinGroupName`
@@ -76,6 +83,16 @@ type ApcliConfig = boolean | {
  * is applied per-instance during the cli.ts collision check.
  */
 declare const RESERVED_GROUP_NAMES: ReadonlySet<string>;
+/**
+ * Canonical set of apcli subcommand names.
+ *
+ * Declarative mirror of the registration TABLE in `src/main.ts`
+ * (`_registerApcliSubcommands`). Used by `_normalizeList` to warn on
+ * unknown entries in include/exclude lists (spec §7 error table / T-APCLI-25).
+ *
+ * Keep in sync with main.ts TABLE if subcommands are added or removed.
+ */
+declare const APCLI_SUBCOMMAND_NAMES: ReadonlySet<string>;
 /**
  * Visibility configuration for the built-in `apcli` command group.
  *
@@ -178,7 +195,7 @@ declare class ApcliGroup {
  * Protocol spec: CLI command structure & lazy loading
  */
 
-/** Placeholder for apcore-js Registry. */
+/** CLI-internal Registry shim (see D9-W2 note above). */
 interface Registry {
     listModules(): ModuleDescriptor[];
     getModule(moduleId: string): ModuleDescriptor | null;
@@ -375,7 +392,9 @@ declare class GroupedModuleGroup extends LazyModuleGroup {
  */
 declare function validateModuleId(moduleId: string): void;
 
-/** Set the verbose help flag. When false, built-in options are hidden from help. */
+/** Set the all-options help flag. When false, built-in options are hidden from help. */
+declare function setAllOptionsHelp(allOptions: boolean): void;
+/** @deprecated Use {@link setAllOptionsHelp} instead. Kept for backward compatibility. */
 declare function setVerboseHelp(verbose: boolean): void;
 /**
  * Set the base URL for online documentation links shown in help and man pages.
@@ -417,6 +436,12 @@ interface APCore {
 interface CreateCliOptions {
     extensionsDir?: string;
     progName?: string;
+    /**
+     * Show all options in help output (controls `--all-options` behaviour;
+     * parameter was named `verbose` prior to v0.9.0).
+     */
+    allOptions?: boolean;
+    /** @deprecated Use {@link allOptions} instead. Kept for backward compatibility with pre-v0.9.0 callers. */
     verbose?: boolean;
     /**
      * APCore unified client instance (apcore-js >= 0.18.0).
@@ -493,9 +518,10 @@ interface CreateCliOptions {
  *
  * @param extensionsDirOrOpts  Path to extensions directory, or a CreateCliOptions object.
  * @param progName       Program name shown in help (default: apcore-cli)
- * @param verbose        Show verbose help output
+ * @param allOptions     Show all options in help output (controls `--all-options` behaviour;
+ *                       parameter was named `verbose` prior to v0.9.0)
  */
-declare function createCli(extensionsDirOrOpts?: string | CreateCliOptions, progName?: string, verbose?: boolean): Command;
+declare function createCli(extensionsDirOrOpts?: string | CreateCliOptions, progName?: string, allOptions?: boolean): Command;
 /** Options bag for {@link applyToolkitIntegration}. */
 interface ApplyToolkitIntegrationOptions {
     /**
@@ -826,6 +852,18 @@ declare class ApprovalDeniedError extends Error {
 declare class SchemaValidationError extends Error {
     constructor(message?: string);
 }
+/** Thrown when $ref resolution depth exceeds the configured maximum. */
+declare class MaxDepthExceededError extends Error {
+    constructor(message?: string);
+}
+/** Thrown when a circular $ref is detected during schema resolution. */
+declare class CircularRefError extends Error {
+    constructor(message?: string);
+}
+/** Thrown when a $ref target cannot be found in $defs/definitions. */
+declare class UnresolvableRefError extends Error {
+    constructor(message?: string);
+}
 /** Thrown when a module is not found. */
 declare class ModuleNotFoundError extends Error {
     constructor(message?: string);
@@ -950,8 +988,19 @@ declare class ConfigEncryptor {
  */
 declare class AuthProvider {
     private readonly config;
-    private readonly encryptor;
+    private readonly _encryptor?;
     constructor(config: ConfigResolver, encryptor?: ConfigEncryptor);
+    /**
+     * Resolve the active ConfigEncryptor instance.
+     *
+     * D11-005 (2026-05-12): three-tier fallback chain matching Python's
+     * `_get_encryptor` (auth.py:33): explicit constructor arg > peer attribute
+     * `config.encryptor` (set by embedders injecting forced-AES test fixtures
+     * or shared instances) > fresh `new ConfigEncryptor()`. Previously TS
+     * skipped the peer-attribute tier, silently giving embedders a different
+     * encryptor than the one they wired on the config.
+     */
+    private getEncryptor;
     /**
      * Retrieve the API key from the configured sources.
      * Handles keyring: and enc: prefixes via ConfigEncryptor.
@@ -1027,4 +1076,4 @@ declare class Sandbox {
     private _sandboxedExecute;
 }
 
-export { type APCore, type ApcliConfig, ApcliGroup, ApcliGroupError, type ApcliMode, type ApplyToolkitIntegrationOptions, ApprovalDeniedError, ApprovalTimeoutError, AuditLogger, AuthProvider, AuthenticationError, CliApprovalHandler, ConfigDecryptionError, ConfigEncryptor, ConfigResolver, type CreateCliOptions, DEFAULTS, EXIT_CODES, type Executor, type ExitCode, ExposureFilter, GroupedModuleGroup, LazyGroup, LazyModuleGroup, type ModuleDescriptor, ModuleExecutionError, ModuleNotFoundError, type OptionConfig, type PipelineTrace, type PipelineTraceStep, type PreflightCheck, type PreflightResult, RESERVED_GROUP_NAMES, type Registry, Sandbox, SchemaValidationError, type StrategyInfo, type StrategyStep, applyToolkitIntegration, buildModuleCommand, checkApproval, collectInput, configureManHelp, createCli, exitCodeForError, formatExecResult, formatModuleDetail, formatModuleList, getAuditLogger, getLogLevel, main, reconvertEnumValues, registerCompletionCommand, registerConfigCommand, registerConfigNamespace, registerDescribeCommand, registerDisableCommand, registerEnableCommand, registerExecCommand, registerHealthCommand, registerInitCommand, registerListCommand, registerPipelineCommand, registerReloadCommand, registerUsageCommand, registerValidateCommand, resolveFormat, resolveRefs, schemaToCliOptions, setAuditLogger, setDocsUrl, setLogLevel, setVerboseHelp, validateModuleId };
+export { APCLI_SUBCOMMAND_NAMES, type APCore, type ApcliConfig, ApcliGroup, ApcliGroupError, type ApcliMode, type ApplyToolkitIntegrationOptions, ApprovalDeniedError, ApprovalTimeoutError, AuditLogger, AuthProvider, AuthenticationError, CircularRefError, CliApprovalHandler, ConfigDecryptionError, ConfigEncryptor, ConfigResolver, type CreateCliOptions, DEFAULTS, DEFAULT_BUILTIN_GROUP_NAME, EXIT_CODES, type Executor, type ExitCode, ExposureFilter, GroupedModuleGroup, LazyGroup, LazyModuleGroup, MaxDepthExceededError, type ModuleDescriptor, ModuleExecutionError, ModuleNotFoundError, type OptionConfig, type PipelineTrace, type PipelineTraceStep, type PreflightCheck, type PreflightResult, RESERVED_GROUP_NAMES, type Registry, Sandbox, SchemaValidationError, type StrategyInfo, type StrategyStep, UnresolvableRefError, applyToolkitIntegration, buildModuleCommand, checkApproval, collectInput, configureManHelp, createCli, exitCodeForError, formatExecResult, formatModuleDetail, formatModuleList, getAuditLogger, getLogLevel, main, reconvertEnumValues, registerCompletionCommand, registerConfigCommand, registerConfigNamespace, registerDescribeCommand, registerDisableCommand, registerEnableCommand, registerExecCommand, registerHealthCommand, registerInitCommand, registerListCommand, registerPipelineCommand, registerReloadCommand, registerUsageCommand, registerValidateCommand, resolveFormat, resolveRefs, schemaToCliOptions, setAllOptionsHelp, setAuditLogger, setDocsUrl, setLogLevel, setVerboseHelp, validateModuleId };