specfact-cli 0.42.6__tar.gz → 0.43.2__tar.gz

{specfact_cli-0.42.6 → specfact_cli-0.43.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfact-cli
-Version: 0.42.6
+Version: 0.43.2
 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
@@ -282,11 +282,15 @@ Description-Content-Type: text/markdown
 # SpecFact CLI
 
 > **The "swiss knife" CLI that turns any codebase into a clear, safe, and shippable workflow.**
-> Keep backlog, specs, tests, and code in sync so AI-assisted changes do not break production.
+> Keep backlog, specs, tests, and code in sync so changes made by people or AI copilots do not break production.
 > Works for brand-new projects and long-lived codebases - even if you are new to coding.
 
 **No API keys required. Works offline. Zero vendor lock-in.**
 
+SpecFact CLI does **not** include built-in AI. It is a deterministic local CLI
+that can be paired with IDE slash-command prompts so your chosen AI copilot can
+invoke SpecFact as part of a command chain.
+
 [![PyPI version](https://img.shields.io/pypi/v/specfact-cli.svg?color=22c55e)](https://pypi.org/project/specfact-cli/)
 [![Python versions](https://img.shields.io/pypi/pyversions/specfact-cli.svg)](https://pypi.org/project/specfact-cli/)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)

{specfact_cli-0.42.6 → specfact_cli-0.43.2}/README.md

@@ -1,11 +1,15 @@
 # SpecFact CLI
 
 > **The "swiss knife" CLI that turns any codebase into a clear, safe, and shippable workflow.**
-> Keep backlog, specs, tests, and code in sync so AI-assisted changes do not break production.
+> Keep backlog, specs, tests, and code in sync so changes made by people or AI copilots do not break production.
 > Works for brand-new projects and long-lived codebases - even if you are new to coding.
 
 **No API keys required. Works offline. Zero vendor lock-in.**
 
+SpecFact CLI does **not** include built-in AI. It is a deterministic local CLI
+that can be paired with IDE slash-command prompts so your chosen AI copilot can
+invoke SpecFact as part of a command chain.
+
 [![PyPI version](https://img.shields.io/pypi/v/specfact-cli.svg?color=22c55e)](https://pypi.org/project/specfact-cli/)
 [![Python versions](https://img.shields.io/pypi/pyversions/specfact-cli.svg)](https://pypi.org/project/specfact-cli/)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)

{specfact_cli-0.42.6 → specfact_cli-0.43.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "specfact-cli"
-version = "0.42.6"
+version = "0.43.2"
 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"
@@ -217,6 +217,12 @@ workflows-lint = "bash scripts/yaml-tools.sh workflows-lint {args}"
 yaml-fix-all = "bash scripts/yaml-tools.sh fix-all {args}"
 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"
+doc-frontmatter-check = "python scripts/check_doc_frontmatter.py"
+docs-validate = "python scripts/check-docs-commands.py && python scripts/check-cross-site-links.py --warn-only && python scripts/check_doc_frontmatter.py"
+
 # Legacy entry (kept for compatibility); prefer `workflows-lint` above
 lint-workflows = "bash scripts/run_actionlint.sh {args}"
 
@@ -386,7 +392,6 @@ only-include = [
 sources = ["src"]
 
 [tool.hatch.build.targets.wheel.force-include]
-"resources/prompts" = "specfact_cli/resources/prompts"
 "resources/templates" = "specfact_cli/resources/templates"
 "resources/schemas" = "specfact_cli/resources/schemas"
 "resources/mappings" = "specfact_cli/resources/mappings"
@@ -714,6 +719,14 @@ ignore = [
     "SLF001", # private member accessed
 ]
 
+"tests/unit/tools/test_smart_test_coverage.py" = [
+    "E402",   # imports after sys.path bootstrap for tool harness loading
+]
+
+"tests/unit/tools/test_smart_test_coverage_enhanced.py" = [
+    "E402",   # imports after sys.path bootstrap for tool harness loading
+]
+
 # Tools and scripts can be more lenient
 "tools/**/*" = [
     "T20",    # print found

{specfact_cli-0.42.6 → specfact_cli-0.43.2}/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.42.6"
+__version__ = "0.43.2"

{specfact_cli-0.42.6 → specfact_cli-0.43.2}/src/specfact_cli/__init__.py

@@ -6,6 +6,9 @@ This package provides command-line tools for:
 - Keeping backlog, specs, tests, and code in sync
 - Enforcing validation and contract checks before production
 - Supporting agile ceremonies and team workflows
+
+When a sibling ``specfact-cli-modules`` checkout exists, startup prepends each bundle's ``src``
+to ``sys.path`` so local development can load marketplace packages without installing wheels.
 """
 
 from __future__ import annotations
@@ -42,6 +45,6 @@ def _bootstrap_bundle_paths() -> None:
 
 _bootstrap_bundle_paths()
 
-__version__ = "0.42.6"
+__version__ = "0.43.2"
 
 __all__ = ["__version__"]

{specfact_cli-0.42.6 → specfact_cli-0.43.2}/src/specfact_cli/adapters/speckit.py

@@ -9,6 +9,8 @@ from __future__ import annotations
 
 import hashlib
 import re
+import shutil
+import subprocess
 from pathlib import Path
 from typing import Any
 
@@ -16,6 +18,7 @@ from beartype import beartype
 from icontract import ensure, require
 
 from specfact_cli.adapters.base import BridgeAdapter
+from specfact_cli.common import get_bridge_logger
 from specfact_cli.importers.speckit_converter import SpecKitConverter
 from specfact_cli.importers.speckit_scanner import SpecKitScanner
 from specfact_cli.models.bridge import BridgeConfig
@@ -35,6 +38,9 @@ from specfact_cli.utils.icontract_helpers import (
 )
 
 
+logger = get_bridge_logger(__name__)
+
+
 class SpecKitAdapter(BridgeAdapter):
     """
     Spec-Kit bridge adapter implementing BridgeAdapter interface.
@@ -83,6 +89,73 @@ class SpecKitAdapter(BridgeAdapter):
             or (docs_specs_dir.exists() and docs_specs_dir.is_dir())
         )
 
+    @beartype
+    @ensure(lambda result: result is None or isinstance(result, str), "Must return str or None")
+    def _detect_version_from_cli(self, repo_path: Path) -> str | None:
+        """Attempt to detect spec-kit version by running the specify CLI."""
+        if not shutil.which("specify"):
+            return None
+        try:
+            result = subprocess.run(
+                ["specify", "--version"],
+                capture_output=True,
+                text=True,
+                timeout=5,
+                cwd=str(repo_path),
+            )
+            if result.returncode == 0 and result.stdout.strip():
+                version_match = re.search(r"(\d+\.\d+\.\d+)", result.stdout)
+                if version_match:
+                    return version_match.group(1)
+        except subprocess.TimeoutExpired:
+            logger.debug("specify --version timed out after 5 seconds")
+        except OSError as exc:
+            logger.debug("specify --version failed due to OSError: %s", exc)
+        return None
+
+    @beartype
+    @ensure(lambda result: result is None or isinstance(result, str), "Must return str or None")
+    def _detect_version_from_heuristics(self, repo_path: Path) -> str | None:
+        """Estimate spec-kit version from directory structure presence."""
+        if (repo_path / "presets").is_dir():
+            return ">=0.3.0"
+        if (repo_path / "extensions").is_dir():
+            return ">=0.2.0"
+        if (repo_path / ".specify").is_dir():
+            return ">=0.1.0"
+        return None
+
+    @staticmethod
+    def _detect_layout(base_path: Path) -> tuple[str, str]:
+        """Determine spec-kit layout type and specs directory from repo structure."""
+        if (base_path / "docs" / "specs").exists():
+            return "modern", "docs/specs"
+        if (base_path / ".specify").exists():
+            return "modern", "specs"
+        return "classic", "specs"
+
+    def _detect_version(self, base_path: Path, *, skip_cli: bool) -> tuple[str | None, str | None]:
+        """Detect spec-kit version, returning (version, source)."""
+        if not skip_cli:
+            version = self._detect_version_from_cli(base_path)
+            if version:
+                return version, "cli"
+        version = self._detect_version_from_heuristics(base_path)
+        if version:
+            return version, "heuristic"
+        return None, None
+
+    @staticmethod
+    def _extract_extension_fields(
+        ext_list: list[dict[str, Any]],
+    ) -> tuple[list[str] | None, dict[str, list[str]] | None]:
+        """Extract extension names and command maps from scanner output."""
+        if not ext_list:
+            return None, None
+        names = [e["name"] for e in ext_list]
+        commands = {e["name"]: e.get("commands", []) for e in ext_list}
+        return names, commands
+
     @beartype
     @require(require_repo_path_exists, "Repository path must exist")
     @require(require_repo_path_is_dir, "Repository path must be a directory")
@@ -98,37 +171,30 @@ class SpecKitAdapter(BridgeAdapter):
         Returns:
             ToolCapabilities instance for Spec-Kit adapter
         """
-        base_path = repo_path
-        if bridge_config and bridge_config.external_base_path:
-            base_path = bridge_config.external_base_path
-
-        # Determine layout (classic vs modern)
-        specify_dir = base_path / ".specify"
-        docs_specs_dir = base_path / "docs" / "specs"
-
-        if docs_specs_dir.exists():
-            layout = "modern"
-            specs_dir_path = "docs/specs"
-        elif specify_dir.exists():
-            layout = "modern"
-            specs_dir_path = "specs"
-        else:
-            layout = "classic"
-            specs_dir_path = "specs"
+        is_cross_repo = bridge_config is not None and bridge_config.external_base_path is not None
+        base_path: Path = bridge_config.external_base_path if is_cross_repo else repo_path  # type: ignore[assignment]
 
-        # Check for constitution file (set has_custom_hooks flag)
+        layout, specs_dir_path = self._detect_layout(base_path)
         scanner = SpecKitScanner(base_path)
         has_constitution, _ = scanner.has_constitution()
-        has_custom_hooks = has_constitution
+        version, detected_version_source = self._detect_version(base_path, skip_cli=is_cross_repo)
+        extensions, extension_commands = self._extract_extension_fields(scanner.scan_extensions())
+        preset_names = scanner.scan_presets()
+        hook_list = scanner.scan_hook_events()
 
         return ToolCapabilities(
             tool="speckit",
-            version=None,  # Spec-Kit version not tracked in files
+            version=version,
             layout=layout,
             specs_dir=specs_dir_path,
-            has_external_config=bridge_config is not None and bridge_config.external_base_path is not None,
-            has_custom_hooks=has_custom_hooks,
-            supported_sync_modes=["bidirectional", "unidirectional"],  # Spec-Kit supports bidirectional sync
+            has_external_config=is_cross_repo,
+            has_custom_hooks=has_constitution,
+            supported_sync_modes=["bidirectional", "unidirectional"],
+            extensions=extensions,
+            extension_commands=extension_commands,
+            presets=preset_names or None,
+            hook_events=hook_list or None,
+            detected_version_source=detected_version_source,
         )
 
     @beartype

{specfact_cli-0.42.6 → specfact_cli-0.43.2}/src/specfact_cli/importers/speckit_scanner.py

@@ -11,14 +11,20 @@ generate markdown artifacts in specs/ and .specify/ directories.
 
 from __future__ import annotations
 
+import json
 import re
 from contextlib import suppress
 from pathlib import Path
-from typing import Any
+from typing import Any, cast
 
 from beartype import beartype
 from icontract import ensure, require
 
+from specfact_cli.common import get_bridge_logger
+
+
+logger = get_bridge_logger(__name__)
+
 
 def _spec_file_is_markdown(spec_file: Path) -> bool:
     return spec_file.suffix == ".md"
@@ -687,6 +693,122 @@ class SpecKitScanner:
         self._parse_constitution_principles(content, memory_data)
         self._parse_constitution_governance_constraints(content, memory_data)
 
+    def _load_extensionignore(self) -> set[str]:
+        """Load extension names to ignore from .extensionignore file."""
+        extensionignore = self.repo_path / ".extensionignore"
+        if not extensionignore.exists():
+            return set()
+        try:
+            content = extensionignore.read_text(encoding="utf-8")
+            return {line.strip() for line in content.splitlines() if line.strip() and not line.startswith("#")}
+        except OSError:
+            logger.debug("Failed to read .extensionignore, proceeding without ignore rules")
+            return set()
+
+    def _parse_catalog_file(self, catalog_path: Path, ignored: set[str], extensions: list[dict[str, Any]]) -> None:
+        """Parse a single extension catalog JSON file and append results."""
+        if not catalog_path.exists():
+            return
+        try:
+            raw = json.loads(catalog_path.read_text(encoding="utf-8"))
+            parsed: Any = raw
+            items: list[Any] = (
+                parsed if isinstance(parsed, list) else cast("dict[str, Any]", parsed).get("extensions", [])
+            )
+            for item in items:
+                if not isinstance(item, dict):
+                    continue
+                item_dict = cast("dict[str, Any]", item)
+                name: str = str(item_dict.get("name", ""))
+                if name and name not in ignored:
+                    commands: list[str] = list(item_dict.get("commands") or [])
+                    ext_version = item_dict.get("version")
+                    extensions.append(
+                        {"name": name, "commands": commands, "version": str(ext_version) if ext_version else None}
+                    )
+        except (json.JSONDecodeError, OSError) as exc:
+            logger.warning("Malformed extension catalog %s: %s", catalog_path, exc)
+
+    @beartype
+    @ensure(lambda result: isinstance(result, list), "Must return list")
+    def scan_extensions(self) -> list[dict[str, Any]]:
+        """
+        Scan for spec-kit extension catalogs and return parsed extension metadata.
+
+        Parses extensions/catalog.community.json and extensions/catalog.core.json,
+        filtering out extensions listed in .extensionignore.
+
+        Returns:
+            List of extension metadata dicts with at minimum 'name' and 'commands' keys.
+        """
+        extensions_dir = self.repo_path / "extensions"
+        if not extensions_dir.exists() or not extensions_dir.is_dir():
+            return []
+
+        ignored = self._load_extensionignore()
+        extensions: list[dict[str, Any]] = []
+        for catalog_name in ("catalog.core.json", "catalog.community.json"):
+            self._parse_catalog_file(extensions_dir / catalog_name, ignored, extensions)
+
+        return extensions
+
+    @beartype
+    @ensure(lambda result: isinstance(result, list), "Must return list")
+    def scan_presets(self) -> list[str]:
+        """
+        Scan for spec-kit preset catalogs in the presets/ directory.
+
+        Returns:
+            List of detected preset names.
+        """
+        presets_dir = self.repo_path / "presets"
+        if not presets_dir.exists() or not presets_dir.is_dir():
+            return []
+
+        preset_names: list[str] = []
+        for item in presets_dir.iterdir():
+            if item.is_file() and item.suffix == ".json":
+                try:
+                    data: Any = json.loads(item.read_text(encoding="utf-8"))
+                    name = (
+                        str(cast("dict[str, Any]", data).get("name", item.stem))
+                        if isinstance(data, dict)
+                        else item.stem
+                    )
+                    preset_names.append(name)
+                except (json.JSONDecodeError, OSError):
+                    preset_names.append(item.stem)
+            elif item.is_dir():
+                preset_names.append(item.name)
+        return preset_names
+
+    @beartype
+    @ensure(lambda result: isinstance(result, list), "Must return list")
+    def scan_hook_events(self) -> list[str]:
+        """
+        Detect before/after hook event wiring in .specify/prompts/ template files.
+
+        Returns:
+            List of detected hook event types (e.g., ["before_task", "after_task"]).
+        """
+        prompts_dir = self.repo_path / ".specify" / "prompts"
+        if not prompts_dir.exists() or not prompts_dir.is_dir():
+            return []
+
+        hook_events: set[str] = set()
+        hook_pattern = re.compile(r"(before|after)[_-](task|plan|specify|implement|constitution)", re.IGNORECASE)
+
+        for template_file in prompts_dir.glob("*.md"):
+            try:
+                content = template_file.read_text(encoding="utf-8")
+                for match in hook_pattern.finditer(content):
+                    event = f"{match.group(1).lower()}_{match.group(2).lower()}"
+                    hook_events.add(event)
+            except OSError:
+                continue
+
+        return sorted(hook_events)
+
     @ensure(lambda result: isinstance(result, dict), "Must return dict")
     def parse_memory_files(self, memory_dir: Path) -> dict[str, Any]:
         """

{specfact_cli-0.42.6 → specfact_cli-0.43.2}/src/specfact_cli/models/bridge.py

@@ -255,7 +255,7 @@ class BridgeConfig(BaseModel):
         }
 
         commands = {
-            "analyze": CommandMapping(
+            "specify": CommandMapping(
                 trigger="/speckit.specify",
                 input_ref="specification",
             ),
@@ -264,6 +264,27 @@ class BridgeConfig(BaseModel):
                 input_ref="specification",
                 output_ref="plan",
             ),
+            "tasks": CommandMapping(
+                trigger="/speckit.tasks",
+                input_ref="plan",
+                output_ref="tasks",
+            ),
+            "implement": CommandMapping(
+                trigger="/speckit.implement",
+                input_ref="tasks",
+            ),
+            "constitution": CommandMapping(
+                trigger="/speckit.constitution",
+                input_ref="constitution",
+            ),
+            "clarify": CommandMapping(
+                trigger="/speckit.clarify",
+                input_ref="specification",
+            ),
+            "analyze": CommandMapping(
+                trigger="/speckit.analyze",
+                input_ref="specification",
+            ),
         }
 
         templates = TemplateMapping(
@@ -319,7 +340,7 @@ class BridgeConfig(BaseModel):
         }
 
         commands = {
-            "analyze": CommandMapping(
+            "specify": CommandMapping(
                 trigger="/speckit.specify",
                 input_ref="specification",
             ),
@@ -328,6 +349,27 @@ class BridgeConfig(BaseModel):
                 input_ref="specification",
                 output_ref="plan",
             ),
+            "tasks": CommandMapping(
+                trigger="/speckit.tasks",
+                input_ref="plan",
+                output_ref="tasks",
+            ),
+            "implement": CommandMapping(
+                trigger="/speckit.implement",
+                input_ref="tasks",
+            ),
+            "constitution": CommandMapping(
+                trigger="/speckit.constitution",
+                input_ref="constitution",
+            ),
+            "clarify": CommandMapping(
+                trigger="/speckit.clarify",
+                input_ref="specification",
+            ),
+            "analyze": CommandMapping(
+                trigger="/speckit.analyze",
+                input_ref="specification",
+            ),
         }
 
         templates = TemplateMapping(
@@ -380,7 +422,7 @@ class BridgeConfig(BaseModel):
         }
 
         commands = {
-            "analyze": CommandMapping(
+            "specify": CommandMapping(
                 trigger="/speckit.specify",
                 input_ref="specification",
             ),
@@ -389,6 +431,27 @@ class BridgeConfig(BaseModel):
                 input_ref="specification",
                 output_ref="plan",
             ),
+            "tasks": CommandMapping(
+                trigger="/speckit.tasks",
+                input_ref="plan",
+                output_ref="tasks",
+            ),
+            "implement": CommandMapping(
+                trigger="/speckit.implement",
+                input_ref="tasks",
+            ),
+            "constitution": CommandMapping(
+                trigger="/speckit.constitution",
+                input_ref="constitution",
+            ),
+            "clarify": CommandMapping(
+                trigger="/speckit.clarify",
+                input_ref="specification",
+            ),
+            "analyze": CommandMapping(
+                trigger="/speckit.analyze",
+                input_ref="specification",
+            ),
         }
 
         templates = TemplateMapping(

{specfact_cli-0.42.6 → specfact_cli-0.43.2}/src/specfact_cli/models/capabilities.py

@@ -18,3 +18,9 @@ class ToolCapabilities:
     supported_sync_modes: list[str] | None = (
         None  # Supported sync modes (e.g., ["bidirectional", "unidirectional", "read-only", "export-only"])
     )
+    # Spec-Kit v0.4.x alignment fields
+    extensions: list[str] | None = None  # Detected extension names (e.g., ["reconcile", "sync", "verify"])
+    extension_commands: dict[str, list[str]] | None = None  # Extension name → provided commands
+    presets: list[str] | None = None  # Active preset names
+    hook_events: list[str] | None = None  # Detected hook event types (e.g., ["before_task", "after_task"])
+    detected_version_source: str | None = None  # How version was detected: "cli", "heuristic", or None

{specfact_cli-0.42.6 → specfact_cli-0.43.2}/src/specfact_cli/modules/init/module-package.yaml

@@ -1,5 +1,5 @@
 name: init
-version: 0.1.18
+version: 0.1.19
 commands:
   - init
 category: core
@@ -17,5 +17,5 @@ publisher:
 description: Initialize SpecFact workspace and bootstrap local configuration.
 license: Apache-2.0
 integrity:
-  checksum: sha256:218801ddd11b02e90e386a3019685add0d14a9a09d246ef958c05f53c9b46a72
-  signature: o9QdwF5+ASt8dJy5D38PgMy7pysqZUJqOaDHHjcRPXoI1dGpeSyOKjJOOtboqoH9qN2a+4nhZX6S5NGp8hlPCA==
+  checksum: sha256:a0ca0fb136f278a11a113be78047c3c7037de9a393c27f8e677a26c4ab2ba659
+  signature: r3czsyG/tinaxMTd/lNkhjXQqRUU0ecLywXt1iDWPO0QuExVM+msp5tuAud03QPnuCsMXNdyBWWSDBovPeY+Aw==

{specfact_cli-0.42.6 → specfact_cli-0.43.2}/src/specfact_cli/modules/init/src/commands.py

@@ -38,7 +38,6 @@ from specfact_cli.utils.ide_setup import (
     discover_prompt_sources_catalog,
     discover_prompt_template_files,
     expected_ide_prompt_export_paths,
-    find_package_resources_path,
     load_ide_prompt_export_source_ids,
     write_ide_prompt_export_state,
 )
@@ -310,8 +309,8 @@ def _select_module_ids_interactive(action: str, modules_list: list[dict[str, Any
 
 
 def _resolve_templates_dir(repo_path: Path) -> Path | None:
-    """Resolve templates directory from repo checkout or installed package."""
-    prompt_files = discover_prompt_template_files(repo_path, include_package_fallback=False)
+    """Resolve a representative templates directory from installed modules or a dev repo checkout."""
+    prompt_files = discover_prompt_template_files(repo_path, include_package_fallback=True)
     if prompt_files:
         return prompt_files[0].parent
 
@@ -319,7 +318,7 @@ def _resolve_templates_dir(repo_path: Path) -> Path | None:
     if dev_templates_dir.exists():
         return dev_templates_dir
 
-    return find_package_resources_path("specfact_cli", "resources/prompts")
+    return None
 
 
 def _audit_prompt_installation(repo_path: Path) -> None:

{specfact_cli-0.42.6 → specfact_cli-0.43.2}/src/specfact_cli/registry/module_lifecycle.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Any
+from typing import Any, cast
 
 from beartype import beartype
 from icontract import ensure, require
@@ -120,7 +120,8 @@ def _questionary_style() -> Any:
         import questionary  # type: ignore[reportMissingImports]
     except ImportError:
         return None
-    return questionary.Style(
+    q = cast(Any, questionary)
+    return q.Style(
         [
             ("qmark", "fg:#00af87 bold"),
             ("question", "bold"),
@@ -209,7 +210,8 @@ def select_module_ids_interactive(action: str, modules_list: list[dict[str, Any]
     console.print(f"[cyan]{action_title} Modules[/cyan] (currently {current_state})")
     console.print("[dim]Controls: arrows navigate, space toggle, enter confirm[/dim]")
     display_to_id, choices = _checkbox_choices_for_modules(candidates)
-    selected: list[str] | None = questionary.checkbox(
+    q = cast(Any, questionary)
+    selected: list[str] | None = q.checkbox(
         f"{action_title} module(s):",
         choices=choices,
         instruction="(multi-select)",

{specfact_cli-0.42.6 → specfact_cli-0.43.2}/src/specfact_cli/utils/ide_setup.py

@@ -259,8 +259,10 @@ def discover_prompt_sources_catalog(
     """
     Build prompt templates grouped by owning source: ``core`` or a module id (``module-package.yaml`` name).
 
-    Core templates come from the repo checkout or the installed ``specfact_cli`` package. Module templates
-    are discovered from effective module roots (builtin, project, user, marketplace, custom).
+    Core templates may come from a repo checkout under ``resources/prompts`` or the installed package when
+    present; workflow prompts are normally provided by bundle modules under ``resources/prompts`` at the
+    module root. Module templates are discovered from effective module roots (builtin, project, user,
+    marketplace, custom).
 
     When a module ships a template with the same source filename as core (e.g. ``specfact.01-import.md``),
     the module copy wins: core does not list that basename so exports stay single-sourced.