fix: prevent click parameter mismatch by setting expose_value=False for the --man option

Author: tercel

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to apcore-cli (Python SDK) will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+
+## [0.4.1] - 2026-03-30
+
+### Fixed
+- prevent click parameter mismatch by setting expose_value=False for the --man option
+
 ## [0.4.0] - 2026-03-29
 
 ### Added

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "apcore-cli"
-version = "0.4.0"
+version = "0.4.1"
 description = "Terminal adapter for apcore — execute AI-Perceivable modules from the command line"
 readme = "README.md"
 license = "Apache-2.0"

src/apcore_cli/shell.py

@@ -501,13 +501,17 @@ def configure_man_help(
     Usage:
         configure_man_help(cli, "reach", "0.2.0", "ReachForge", "https://reachforge.dev/docs")
     """
-    # Add --man as a hidden Click option
+    # Add --man as a hidden Click option.
+    # expose_value=False: Click must not pass this to the group callback,
+    # which has no 'man' parameter. The value is read directly from sys.argv
+    # via the pre-parse below.
     cli.params.append(
         click.Option(
             ["--man"],
             is_flag=True,
             default=False,
             hidden=True,
+            expose_value=False,
             help="Output man page in roff format (use with --help).",
         )
     )