specfact-cli 0.46.25__tar.gz → 0.47.3__tar.gz

{specfact_cli-0.46.25 → specfact_cli-0.47.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfact-cli
-Version: 0.46.25
+Version: 0.47.3
 Summary: The swiss knife CLI for agile DevOps teams. Keep backlog, specs, tests, and code in sync with validation and contract enforcement for new projects and long-lived codebases.
 Project-URL: Homepage, https://github.com/nold-ai/specfact-cli
 Project-URL: Repository, https://github.com/nold-ai/specfact-cli.git
@@ -299,6 +299,11 @@ Description-Content-Type: text/markdown
 
 </div>
 
+## Command Overview
+
+- [Generated command overview for humans](docs/reference/commands.generated.md)
+- [AI-agent command overview](llms.txt)
+
 ## Try it in 60 seconds
 
 ```bash
@@ -342,6 +347,8 @@ specfact code review run --path . --scope full
 
 The sample output comes from a pinned capture against `nold-ai/specfact-demo-repo`. Reproduce it with `docs/_support/readme-first-contact/capture-readme-output.sh`; capture metadata lives alongside the raw logs in `docs/_support/readme-first-contact/sample-output/`.
 
+The Code Review bundle also reports `ai_bloat` advisories for code shapes that AI-assisted coding often amplifies, such as redundant wrappers, passthrough lambdas, identity `try`/`except` blocks, and avoidable intermediate lists. These findings are advisory, score-neutral, and not AI-authorship detection. Use the generated `.specfact/code-review.json` report with the Project bundle's `/specfact.08-simplify` IDE prompt to review each cleanup before accepting it. See the [AI bloat quickstart](https://modules.specfact.io/quickstart-ai-bloat/) on the modules docs site.
+
 ## What SpecFact does
 
 - **Reviews AI-assisted changes deterministically** — compare code against contracts, clean-code rules, and policy gates

{specfact_cli-0.46.25 → specfact_cli-0.47.3}/README.md

@@ -16,6 +16,11 @@
 
 </div>
 
+## Command Overview
+
+- [Generated command overview for humans](docs/reference/commands.generated.md)
+- [AI-agent command overview](llms.txt)
+
 ## Try it in 60 seconds
 
 ```bash
@@ -59,6 +64,8 @@ specfact code review run --path . --scope full
 
 The sample output comes from a pinned capture against `nold-ai/specfact-demo-repo`. Reproduce it with `docs/_support/readme-first-contact/capture-readme-output.sh`; capture metadata lives alongside the raw logs in `docs/_support/readme-first-contact/sample-output/`.
 
+The Code Review bundle also reports `ai_bloat` advisories for code shapes that AI-assisted coding often amplifies, such as redundant wrappers, passthrough lambdas, identity `try`/`except` blocks, and avoidable intermediate lists. These findings are advisory, score-neutral, and not AI-authorship detection. Use the generated `.specfact/code-review.json` report with the Project bundle's `/specfact.08-simplify` IDE prompt to review each cleanup before accepting it. See the [AI bloat quickstart](https://modules.specfact.io/quickstart-ai-bloat/) on the modules docs site.
+
 ## What SpecFact does
 
 - **Reviews AI-assisted changes deterministically** — compare code against contracts, clean-code rules, and policy gates

{specfact_cli-0.46.25 → specfact_cli-0.47.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "specfact-cli"
-version = "0.46.25"
+version = "0.47.3"
 description = "The swiss knife CLI for agile DevOps teams. Keep backlog, specs, tests, and code in sync with validation and contract enforcement for new projects and long-lived codebases."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -247,12 +247,15 @@ yaml-check-all = "bash scripts/yaml-tools.sh check-all {args}"
 # Docs validation (docs-12): command examples vs CLI; modules.specfact.io URLs in docs
 check-docs-commands = "python scripts/check-docs-commands.py"
 check-cross-site-links = "python scripts/check-cross-site-links.py"
+generate-command-overview = "python scripts/generate-command-overview.py --write"
+check-command-overview = "python scripts/generate-command-overview.py --check"
+check-command-contract = "python scripts/check-command-contract.py"
 doc-frontmatter-check = "python scripts/check_doc_frontmatter.py"
 validate-agent-rule-signals = "python scripts/validate_agent_rule_applies_when.py"
 check-version-sources = "python scripts/check_version_sources.py"
 check-pypi-ahead = "python scripts/check_local_version_ahead_of_pypi.py"
 release = "python scripts/check_local_version_ahead_of_pypi.py && python scripts/check_version_sources.py"
-docs-validate = "python scripts/check-docs-commands.py && python scripts/check-cross-site-links.py --warn-only && python scripts/check_doc_frontmatter.py && python scripts/validate_agent_rule_applies_when.py"
+docs-validate = "python scripts/generate-command-overview.py --check && python scripts/check-command-contract.py && python scripts/check-docs-commands.py && python scripts/check-cross-site-links.py --warn-only && python scripts/check_doc_frontmatter.py && python scripts/validate_agent_rule_applies_when.py"
 
 # Legacy entry (kept for compatibility); prefer `workflows-lint` above
 lint-workflows = "bash scripts/run_actionlint.sh {args}"

specfact_cli-0.47.3/resources/bundled-module-registry/index.json

@@ -0,0 +1,26 @@
+{
+  "modules": [
+    {
+      "checksum_sha256": "3a563335d7a5e16e6e9ec975d6e5c77ff550d8880474eca03713b43e97d39a4a",
+      "download_url": "https://github.com/nold-ai/specfact-cli/releases/download/init-0.1.37.tar.gz",
+      "id": "init",
+      "latest_version": "0.1.37"
+    },
+    {
+      "checksum_sha256": "35c592374b209224af9a826c21efa66947cc16bf680b20ee0463f44bee4f9b59",
+      "download_url": "https://github.com/nold-ai/specfact-cli/releases/download/upgrade-0.1.21.tar.gz",
+      "id": "upgrade",
+      "latest_version": "0.1.21"
+    },
+    {
+      "checksum_sha256": "79359da27cb1c734a928a453a786b626e7b06654f515f32ead0cf96fa8e70bc2",
+      "download_url": "https://github.com/nold-ai/specfact-cli/releases/download/module-registry-0.1.26.tar.gz",
+      "id": "module-registry",
+      "latest_version": "0.1.26"
+    },
+    {
+      "id": "bundle-mapper",
+      "latest_version": "0.1.9"
+    }
+  ]
+}

{specfact_cli-0.46.25 → specfact_cli-0.47.3}/resources/templates/pr-template.md.j2

@@ -20,7 +20,7 @@
 - **Non-interactive / CI** must bootstrap workflow bundles before `specfact code …` or `specfact project …`:
   - `specfact init --profile solo-developer --repo .` (or another profile / `specfact init --install …`), **or**
   - `specfact module install nold-ai/specfact-codebase` (and other bundles as needed).
-- Contract repro in CI uses **`specfact code repro`** (not `specfact repro`). Optional: `specfact code repro setup` for CrossHair config.
+- Contract repro in CI uses **`specfact code repro`**. Optional: `specfact code repro setup` for CrossHair config.
 - Optional `specfact project version check` needs a project under `.specfact/projects/<bundle>/` and `--bundle <name>`.
 
 **SpecFact CLI Validation Results:**
@@ -64,4 +64,3 @@
 ## 📝 Notes
 
 {{ notes | default("Add any additional notes here") }}
-

{specfact_cli-0.46.25 → specfact_cli-0.47.3}/src/__init__.py

@@ -3,4 +3,4 @@ SpecFact CLI - Spec→Contract→Sentinel tool for contract-driven development.
 """
 
 # Package version: keep in sync with pyproject.toml, setup.py, src/specfact_cli/__init__.py
-__version__ = "0.46.25"
+__version__ = "0.47.3"

{specfact_cli-0.46.25 → specfact_cli-0.47.3}/src/specfact_cli/__init__.py

@@ -13,6 +13,7 @@ to ``sys.path`` so local development can load marketplace packages without insta
 
 from __future__ import annotations
 
+import importlib.util
 import os
 import sys
 from pathlib import Path
@@ -25,6 +26,12 @@ def _candidate_modules_repo_roots() -> list[Path]:
         roots.append(Path(configured).expanduser())
 
     this_file = Path(__file__).resolve()
+    parts = this_file.parts
+    if "specfact-cli-worktrees" in parts:
+        marker_index = parts.index("specfact-cli-worktrees")
+        base = Path(*parts[:marker_index])
+        suffix = Path(*parts[marker_index + 1 : -3])
+        roots.append(base / "specfact-cli-modules-worktrees" / suffix)
     for base in (this_file.parent.parent.parent, *this_file.parents):
         roots.append(base / "specfact-cli-modules")
         roots.append(base.parent / "specfact-cli-modules")
@@ -45,6 +52,29 @@ def _bootstrap_bundle_paths() -> None:
 
 _bootstrap_bundle_paths()
 
-__version__ = "0.46.25"
+
+def _install_progressive_disclosure() -> None:
+    module_name = "_specfact_progressive_disclosure_bootstrap"
+    if module_name in sys.modules:
+        return
+    module_path = Path(__file__).resolve().parent / "utils" / "progressive_disclosure.py"
+    spec = importlib.util.spec_from_file_location(module_name, module_path)
+    if spec is None or spec.loader is None:
+        return
+    module = importlib.util.module_from_spec(spec)
+    sys.modules[module_name] = module
+    try:
+        spec.loader.exec_module(module)
+    except Exception:
+        sys.modules.pop(module_name, None)
+        raise
+
+
+# Install the shared Click/Typer usage-error contract as soon as core is imported.
+# Module packages import specfact_cli before constructing direct Typer apps, so this
+# keeps missing-command and missing-parameter UX consistent outside the root CLI too.
+_install_progressive_disclosure()
+
+__version__ = "0.47.3"
 
 __all__ = ["__version__"]

{specfact_cli-0.46.25 → specfact_cli-0.47.3}/src/specfact_cli/cli.py

@@ -11,6 +11,7 @@ import inspect
 import os
 import sys
 from collections.abc import Callable, Mapping
+from contextlib import suppress
 from dataclasses import dataclass
 from datetime import datetime
 from pathlib import Path
@@ -72,6 +73,12 @@ from specfact_cli.utils.progressive_disclosure import ProgressiveDisclosureGroup
 from specfact_cli.utils.structured_io import StructuredFormat
 
 
+try:
+    from typer._click.exceptions import UsageError as TyperUsageError
+except ImportError:  # pragma: no cover - older Typer delegates directly to Click
+    TyperUsageError = click.UsageError  # type: ignore[assignment,misc]
+
+
 # Names of commands that come from installable bundles; when not registered, show actionable error.
 KNOWN_BUNDLE_GROUP_OR_SHIM_NAMES: frozenset[str] = frozenset(
     {
@@ -165,9 +172,7 @@ class _RootCLIGroup(ProgressiveDisclosureGroup):
     """Root group that shows actionable error when an unknown command is a known bundle group/shim."""
 
     @ensure(lambda result: isinstance(result, tuple) and len(result) == 3, "result must be a 3-tuple")
-    def resolve_command(
-        self, ctx: click.Context, args: list[str]
-    ) -> tuple[str | None, click.Command | None, list[str]]:
+    def resolve_command(self, ctx: Any, args: list[str]) -> Any:
         if not args:
             return super().resolve_command(ctx, args)
         invoked = args[0]
@@ -567,6 +572,10 @@ def _raise_lazy_delegate_click_exception(exc: Exception) -> NoReturn:
     raise click.ClickException(str(exc)) from exc
 
 
+def _is_group_like(command: object) -> bool:
+    return hasattr(command, "list_commands") and hasattr(command, "get_command")
+
+
 def _load_lazy_delegate_typer(cmd_name: str) -> typer.Typer:
     resolved_name = resolve_command(cmd_name)
     try:
@@ -583,7 +592,7 @@ def _build_lazy_delegate_click_command(cmd_name: str, args: tuple[str, ...], rea
     from typer.main import get_command
 
     try:
-        return get_command(real_typer)
+        return cast(click.Command, get_command(real_typer))
     except (RuntimeError, ValueError) as exc:
         if _args_request_help(args):
             _print_lazy_help_fallback(cmd_name, args)
@@ -593,6 +602,15 @@ def _build_lazy_delegate_click_command(cmd_name: str, args: tuple[str, ...], rea
 
 
 def _lazy_delegate_prog_name(ctx: click.Context, cmd_name: str) -> str:
+    original_prog_name = ctx.meta.get("original_prog_name")
+    if not isinstance(original_prog_name, str) and ctx.parent is not None:
+        original_prog_name = ctx.parent.meta.get("original_prog_name")
+    if isinstance(original_prog_name, str) and original_prog_name:
+        return original_prog_name
+    if isinstance(ctx.info_name, str) and " " in ctx.info_name:
+        return ctx.info_name
+    if isinstance(ctx.command_path, str) and " " in ctx.command_path:
+        return ctx.command_path
     parts: list[str] = []
     parent = ctx.parent
     while parent and getattr(parent, "command", None):
@@ -601,20 +619,46 @@ def _lazy_delegate_prog_name(ctx: click.Context, cmd_name: str) -> str:
             parts.append(name)
         parent = getattr(parent, "parent", None)
     if parts:
-        return " ".join(reversed(parts))
-    original_prog_name = ctx.meta.get("original_prog_name")
-    if isinstance(original_prog_name, str) and original_prog_name:
-        return original_prog_name
+        prog_name = " ".join(reversed(parts))
+        if prog_name == cmd_name:
+            return f"specfact {cmd_name}"
+        return prog_name
     return cmd_name
 
 
 def _strip_redundant_single_command_arg(click_cmd: click.Command, args: tuple[str, ...]) -> list[str]:
     args_list = list(args)
-    if not isinstance(click_cmd, click.Group) and args_list and args_list[0] == getattr(click_cmd, "name", None):
+    if not _is_group_like(click_cmd) and args_list and args_list[0] == getattr(click_cmd, "name", None):
         return args_list[1:]
     return args_list
 
 
+def _help_args_before_first_option(args: list[str]) -> list[str]:
+    help_args: list[str] = []
+    for arg in args:
+        if arg.startswith("-"):
+            break
+        help_args.append(arg)
+    return help_args
+
+
+def _lazy_usage_error_message(exc: Exception, command: click.Command, ctx: click.Context | None) -> str:
+    message = str(getattr(exc, "format_message", lambda: str(exc))())
+    if not message.strip().lower().startswith("missing command"):
+        return message
+    names: list[str] = []
+    group = ctx.command if ctx is not None else command
+    if _is_group_like(group):
+        try:
+            command_ctx = ctx or click.Context(cast(click.Command, group))
+            names = [str(name) for name in group.list_commands(command_ctx)]
+        except Exception:
+            names = []
+    if names:
+        return f"Missing subcommand. Choose one of: {', '.join(names)}."
+    return "Missing subcommand."
+
+
 def _lazy_delegate_remaining_args(ctx: click.Context) -> list[str]:
     ctx_state = vars(ctx)
     protected_args = ctx_state.get("_protected_args") or ctx_state.get("protected_args") or ()
@@ -632,7 +676,11 @@ class _LazyDelegateGroup(click.Group):
         super().__init__(
             name=name or cmd_name,
             help=help or help_str,
-            context_settings={"ignore_unknown_options": True},
+            context_settings={
+                "ignore_unknown_options": True,
+                "allow_extra_args": True,
+                "allow_interspersed_args": False,
+            },
             invoke_without_command=True,
             no_args_is_help=False,
         )
@@ -641,37 +689,75 @@ class _LazyDelegateGroup(click.Group):
         self._delegate_cmd = self._make_delegate_command()
 
     def _make_delegate_command(self) -> click.Command:
-        cmd_name = self._lazy_cmd_name
-
         def _invoke(args: tuple[str, ...]) -> None:
-            ctx = click.get_current_context()
-            real_typer = _load_lazy_delegate_typer(cmd_name)
-            click_cmd = _build_lazy_delegate_click_command(cmd_name, args, real_typer)
-            # Build full prog name from root (e.g. "specfact sync") so usage shows "specfact sync bridge", not "sync sync bridge"
-            prog_name = _lazy_delegate_prog_name(ctx, cmd_name)
-            # When the real app is a single command (e.g. drift has only "detect"), Typer
-            # builds a TyperCommand, not a Group. Then args are ["detect", "bundle", "--repo", ...]
-            # and the command expects ["bundle", "--repo", ...] (no leading "detect").
-            args_list = _strip_redundant_single_command_arg(click_cmd, args)
-            exit_code = click_cmd.main(args=args_list, prog_name=prog_name, standalone_mode=False)
-            if exit_code and exit_code != 0:
-                raise SystemExit(exit_code)
+            self._invoke_real_command(click.get_current_context(), args)
 
         return click.Command(
             "__delegate__",
             callback=_invoke,
             params=[click.Argument(["args"], nargs=-1, type=click.UNPROCESSED)],
-            context_settings={"ignore_unknown_options": True},
+            context_settings={
+                "ignore_unknown_options": True,
+                "allow_extra_args": True,
+                "allow_interspersed_args": False,
+            },
             add_help_option=False,  # Pass --help through to real Typer so "specfact backlog daily ado --help" shows correct usage
         )
 
+    def _invoke_real_command(self, ctx: click.Context, args: tuple[str, ...] | list[str]) -> None:
+        cmd_name = self._lazy_cmd_name
+        real_typer = _load_lazy_delegate_typer(cmd_name)
+        args_tuple = tuple(args)
+        click_cmd = _build_lazy_delegate_click_command(cmd_name, args_tuple, real_typer)
+        prog_name = _lazy_delegate_prog_name(ctx, cmd_name)
+        args_list = _strip_redundant_single_command_arg(click_cmd, args_tuple)
+        try:
+            exit_code = click_cmd.main(args=args_list, prog_name=prog_name, standalone_mode=False)
+        except (click.UsageError, TyperUsageError) as exc:
+            if exc.ctx is None:
+                help_args = _help_args_before_first_option(args_list)
+                try:
+                    click_cmd.main(args=[*help_args, "--help"], prog_name=prog_name, standalone_mode=False)
+                except BaseException as help_exit:
+                    if not help_exit.__class__.__name__.endswith("Exit"):
+                        raise
+                click.echo(f"Error: {_lazy_usage_error_message(exc, click_cmd, None)}", file=sys.stderr)
+            else:
+                # Help rendering is best-effort; the primary usage error is emitted below.
+                with suppress(Exception):
+                    click.echo(exc.ctx.get_help(), file=sys.stderr)
+                    click.echo("", file=sys.stderr)
+                click.echo(f"Error: {_lazy_usage_error_message(exc, click_cmd, exc.ctx)}", file=sys.stderr)
+            raise SystemExit(exc.exit_code) from None
+        except SystemExit as exc:
+            code = exc.code if isinstance(exc.code, int) else 1 if exc.code else 0
+            raise SystemExit(code) from None
+        except BaseException as exc:
+            if exc.__class__.__name__.endswith("Exit"):
+                raise SystemExit(getattr(exc, "exit_code", getattr(exc, "code", 0))) from None
+            raise
+        if exit_code and exit_code != 0:
+            raise SystemExit(exit_code)
+
+    def parse_args(self, ctx: click.Context, args: list[str]) -> list[str]:
+        if _args_request_help(args):
+            try:
+                return super().parse_args(ctx, args)
+            except click.exceptions.Exit as exc:
+                raise SystemExit(exc.exit_code) from None
+        ctx.args = list(args)
+        return []
+
     @require(lambda ctx: ctx is not None, "ctx must not be None")
     @ensure(lambda result: result is None or isinstance(result, int), "result must be None or an exit code")
     def invoke(self, ctx: click.Context) -> Any:
         if ctx.invoked_subcommand is None:
             args = _lazy_delegate_remaining_args(ctx)
-            ctx.meta["original_prog_name"] = ctx.command_path
-            return self._delegate_cmd.main(args=args, prog_name=ctx.command_path, standalone_mode=False)
+            command_path = ctx.command_path
+            if command_path == self._lazy_cmd_name:
+                command_path = f"specfact {self._lazy_cmd_name}"
+            ctx.meta["original_prog_name"] = command_path
+            return self._invoke_real_command(ctx, args)
         return super().invoke(ctx)
 
     @require(_lazy_delegate_cmd_name_ready, "lazy command name must be set")
@@ -712,8 +798,8 @@ class _LazyDelegateGroup(click.Group):
             click_cmd = get_command(real_typer)
         except (RuntimeError, ValueError):
             return None
-        if isinstance(click_cmd, click.Group):
-            return click_cmd
+        if _is_group_like(click_cmd):
+            return cast(click.Group, click_cmd)
         return None
 
     @require(_lazy_delegate_cmd_name_ready, "lazy command name must be set before formatting help")
@@ -736,6 +822,10 @@ class _LazyDelegateGroup(click.Group):
             click_cmd.main(args=["-h"], prog_name=prog_name, standalone_mode=False)
         except SystemExit:
             raise  # Re-raise so process exits (help was already printed with Rich)
+        except BaseException as exc:
+            if exc.__class__.__name__.endswith("Exit"):
+                raise SystemExit(getattr(exc, "exit_code", 0)) from None
+            raise
         # main() returned without exiting; Rich help was already printed, skip default formatter
         return
 
@@ -748,7 +838,7 @@ def _build_lazy_delegate_group(cmd_name: str, help_str: str) -> click.Group:
 def _flatten_specfact_nested_subgroup(result: click.Group, flatten_name: str) -> None:
     """Merge a nested subgroup named `flatten_name` into its parent and re-sort command order."""
     redundant = result.commands.pop(flatten_name)
-    if isinstance(redundant, click.Group):
+    if _is_group_like(redundant):
         for cmd_name, cmd in redundant.commands.items():
             result.add_command(cmd, name=cmd_name)
     if result.commands:
@@ -814,6 +904,7 @@ def _get_group_from_info_wrapper(
 _typer_get_group_from_info_original: Callable[..., click.Group] | None = None
 _typer_get_command_original: Callable[[typer.Typer], click.Command] | None = None
 _typer_get_params_original: Callable[..., Any] | None = None
+_typer_get_params_convertors_original: Callable[..., Any] | None = None
 
 
 def _specfact_get_params_from_function(func: Callable[..., Any]) -> Any:
@@ -838,6 +929,55 @@ def _specfact_get_params_from_function(func: Callable[..., Any]) -> Any:
     return orig(func)
 
 
+def _is_context_annotation(annotation: object) -> bool:
+    if annotation in (click.Context, typer.Context):
+        return True
+    return getattr(annotation, "__name__", "") == "Context" and "click" in getattr(annotation, "__module__", "")
+
+
+def _specfact_get_params_convertors_ctx_param_name_from_function(callback: Callable[..., Any] | None) -> Any:
+    """Treat both Click context classes as Typer context parameters across Typer releases."""
+    assert _typer_get_params_convertors_original is not None
+    original_error: RuntimeError | None = None
+    try:
+        return _typer_get_params_convertors_original(callback)
+    except RuntimeError as exc:
+        if callback is None or "click.core.Context" not in str(exc):
+            raise
+        original_error = exc
+    import typer.utils as typer_utils
+
+    params = _specfact_get_params_from_function(callback)
+    ctx_param_name: str | None = None
+    filtered_params: dict[str, Any] = {}
+    for name, param in params.items():
+        if ctx_param_name is None and _is_context_annotation(getattr(param, "annotation", None)):
+            ctx_param_name = name
+            continue
+        filtered_params[name] = param
+
+    if ctx_param_name is None:
+        raise RuntimeError("Unable to identify Click context parameter") from original_error
+
+    typer_main = cast(Any, importlib.import_module("typer.main"))
+    previous_main_get_params = typer_main.get_params_from_function
+    previous_utils_get_params = typer_utils.get_params_from_function
+
+    def _filtered_get_params(func: Callable[..., Any]) -> Any:
+        if func is callback:
+            return filtered_params
+        return previous_main_get_params(func)
+
+    try:
+        typer_main.get_params_from_function = _filtered_get_params
+        typer_utils.get_params_from_function = _filtered_get_params
+        click_params, convertors, _ignored_ctx = _typer_get_params_convertors_original(callback)
+    finally:
+        typer_main.get_params_from_function = previous_main_get_params
+        typer_utils.get_params_from_function = previous_utils_get_params
+    return click_params, convertors, ctx_param_name
+
+
 # Patch so root app build uses our delegate group for lazy typers (built via get_group_from_info).
 def _patch_typer_build() -> None:
     import typer.utils as typer_utils
@@ -845,6 +985,7 @@ def _patch_typer_build() -> None:
     typer_main = cast(Any, importlib.import_module("typer.main"))
 
     global _typer_get_group_from_info_original, _typer_get_command_original, _typer_get_params_original
+    global _typer_get_params_convertors_original
     # Save originals only on first patch; avoid overwriting with our wrapper when cli is re-imported (e.g. by plan module).
     if _typer_get_group_from_info_original is None:
         _typer_get_group_from_info_original = typer_main.get_group_from_info
@@ -852,9 +993,14 @@ def _patch_typer_build() -> None:
         _typer_get_command_original = typer_main.get_command
     if _typer_get_params_original is None:
         _typer_get_params_original = typer_utils.get_params_from_function
+    if _typer_get_params_convertors_original is None:
+        _typer_get_params_convertors_original = typer_main.get_params_convertors_ctx_param_name_from_function
     typer_utils.get_params_from_function = _specfact_get_params_from_function
     # typer.main may have bound get_params_from_function at import time; keep in sync.
     typer_main.get_params_from_function = _specfact_get_params_from_function
+    typer_main.get_params_convertors_ctx_param_name_from_function = (
+        _specfact_get_params_convertors_ctx_param_name_from_function
+    )
     typer_main.get_command = _get_command
     typer_main.get_group_from_info = _get_group_from_info_wrapper
 

{specfact_cli-0.46.25 → specfact_cli-0.47.3}/src/specfact_cli/modules/init/module-package.yaml

@@ -1,5 +1,5 @@
 name: init
-version: 0.1.33
+version: 0.1.37
 commands:
   - init
 category: core
@@ -17,5 +17,5 @@ publisher:
 description: Initialize SpecFact workspace and bootstrap local configuration.
 license: Apache-2.0
 integrity:
-  checksum: sha256:0086a4fa3e1f8744deee21640e73e6e2f24daf2b4a680b9157feed5487afc208
-  signature: L7DtVqvg+zqc/CgJu/mOkvxYpfH9HuddbLS3EK5Uvnf6K/j/BofqopamZDdHVlevOGAb+dbsk06kskNOIJfkDQ==
+  checksum: sha256:8741e8fa3408bd38e7d65d0784a25466369955dd9f16f1981a52c0e1550afbe0
+  signature: kPAMdqpcAr92gr+DwxWibXfD0mgCLSb78EwGzoXH3fHct7xss8zt/SFvJLVZ0qkYHA8/4Nu6ls0iihRN9DXhCw==

{specfact_cli-0.46.25 → specfact_cli-0.47.3}/src/specfact_cli/modules/init/src/commands.py

@@ -7,7 +7,6 @@ import subprocess
 from pathlib import Path
 from typing import Any, cast
 
-import click
 import typer
 from beartype import beartype
 from icontract import ensure, require
@@ -189,6 +188,7 @@ import_to_bundle = module_io_shim.import_to_bundle
 export_from_bundle = module_io_shim.export_from_bundle
 sync_with_bundle = module_io_shim.sync_with_bundle
 validate_bundle = module_io_shim.validate_bundle
+IDE_TARGETS_HELP = ", ".join([*sorted(IDE_CONFIG.keys()), "auto"])
 
 
 def _install_contract_enhancement_dependencies(repo_path: Path, env_info: EnvManagerInfo) -> None:
@@ -614,7 +614,7 @@ def init_ide(
     ide: str | None = typer.Option(
         None,
         "--ide",
-        help="IDE type (cursor, vscode, copilot, claude, gemini, qwen, opencode, windsurf, kilocode, auggie, roo, codebuddy, amp, q, auto)",
+        help=f"IDE/agent target ({IDE_TARGETS_HELP})",
     ),
     env_manager: EnvManager = typer.Option(
         EnvManager.AUTO,
@@ -712,9 +712,8 @@ def init_ide(
 @app.callback(invoke_without_command=True)
 @require(lambda repo: _is_valid_repo_path(repo), "Repo path must exist and be directory")
 @ensure(lambda result: result is None, "Command should return None")
-@beartype
 def init(
-    ctx: click.Context,
+    ctx: typer.Context,
     repo: Path = typer.Option(
         Path("."),
         "--repo",

{specfact_cli-0.46.25 → specfact_cli-0.47.3}/src/specfact_cli/modules/upgrade/module-package.yaml

@@ -1,5 +1,5 @@
 name: upgrade
-version: 0.1.15
+version: 0.1.21
 commands:
   - upgrade
 category: core
@@ -17,5 +17,5 @@ publisher:
 description: Check and apply SpecFact CLI version upgrades.
 license: Apache-2.0
 integrity:
-  checksum: sha256:134da8c48f8be96e9a4337a7cc2076bbf8b19e0d3f69161636bcec050f97e4c1
-  signature: CK8Gq+/d0zWlU1Lo1I6EcgPiT3FzVsXj+CXFn7+zUnpXRdpYZxccLLZqh1Hvl2IPv3Y4yecVlOEcWZKtn0tJBg==
+  checksum: sha256:eae81fc948d038dc857827de5c9c5363c963dea13af9e78395b71aeb5411742b
+  signature: H8A/ySECBGR+f1iCNepv434cQ7MazJr1RMRKoDCPS9IuIoMmL3nm4HNOSBFWPTqeFVgTbMWlISPUSjFaF4AoDg==