specfact-cli 0.42.3__tar.gz → 0.42.4__tar.gz

{specfact_cli-0.42.3 → specfact_cli-0.42.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfact-cli
-Version: 0.42.3
+Version: 0.42.4
 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
@@ -342,6 +342,8 @@ specfact init ide --ide cursor
 specfact init ide --ide vscode
 ```
 
+`specfact init ide` discovers prompt resources from installed workflow modules and exports them to your IDE. If module prompt payloads are not installed yet, the CLI uses packaged fallback resources.
+
 ### Run Your First Flow
 
 ```bash

{specfact_cli-0.42.3 → specfact_cli-0.42.4}/README.md

@@ -61,6 +61,8 @@ specfact init ide --ide cursor
 specfact init ide --ide vscode
 ```
 
+`specfact init ide` discovers prompt resources from installed workflow modules and exports them to your IDE. If module prompt payloads are not installed yet, the CLI uses packaged fallback resources.
+
 ### Run Your First Flow
 
 ```bash

{specfact_cli-0.42.3 → specfact_cli-0.42.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "specfact-cli"
-version = "0.42.3"
+version = "0.42.4"
 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"

{specfact_cli-0.42.3 → specfact_cli-0.42.4}/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.3"
+__version__ = "0.42.4"

{specfact_cli-0.42.3 → specfact_cli-0.42.4}/src/specfact_cli/__init__.py

@@ -42,6 +42,6 @@ def _bootstrap_bundle_paths() -> None:
 
 _bootstrap_bundle_paths()
 
-__version__ = "0.42.3"
+__version__ = "0.42.4"
 
 __all__ = ["__version__"]

{specfact_cli-0.42.3 → specfact_cli-0.42.4}/src/specfact_cli/adapters/ado.py

@@ -12,10 +12,10 @@ from __future__ import annotations
 
 import os
 import re
-from collections.abc import Mapping
+from collections.abc import Callable, Mapping
 from datetime import UTC, datetime
 from pathlib import Path
-from typing import Any, NoReturn, cast
+from typing import Any, NoReturn, Protocol, cast
 from urllib.parse import urlparse
 
 import requests
@@ -51,6 +51,19 @@ _ADO_COMMENTS_API_VERSION = "7.1-preview.4"
 console = Console()
 
 
+class _AccessTokenLike(Protocol):
+    """Typed subset of Azure access token fields used by refresh logic."""
+
+    token: str
+    expires_on: int
+
+
+def _get_access_token(credential: Any, scopes: list[str]) -> _AccessTokenLike:
+    """Return a typed Azure access token from a credential object."""
+    get_token_fn = cast(Callable[..., _AccessTokenLike], credential.get_token)
+    return get_token_fn(*scopes)
+
+
 def _as_str_dict(obj: dict[Any, Any]) -> dict[str, Any]:
     """Narrow a runtime ``dict`` to ``dict[str, Any]`` for static analysis."""
     return cast(dict[str, Any], obj)
@@ -1850,7 +1863,7 @@ class AdoAdapter(BridgeAdapter, BacklogAdapterMixin, BacklogAdapter):
             # offline_access is a reserved scope and cannot be explicitly requested
             azure_devops_resource = "499b84ac-1321-427f-aa17-267ca6975798/.default"
             azure_devops_scopes = [azure_devops_resource]
-            token = credential.get_token(*azure_devops_scopes)
+            token = _get_access_token(credential, azure_devops_scopes)
 
             # Return refreshed token data
             from datetime import UTC, datetime

{specfact_cli-0.42.3 → specfact_cli-0.42.4}/src/specfact_cli/analyzers/code_analyzer.py

@@ -644,26 +644,8 @@ class CodeAnalyzer:
             # Extract classes as features
             for node in ast.walk(tree):
                 if isinstance(node, ast.ClassDef):
-                    # For sequential keys, use placeholder (will be fixed after all features collected)
-                    # For classname keys, we can generate immediately
-                    current_count = 0 if self.key_format == "sequential" else len(self.features)
-
-                    # Extract Semgrep evidence for confidence scoring
-                    class_start_line = node.lineno if hasattr(node, "lineno") else None
-                    class_end_line = node.end_lineno if hasattr(node, "end_lineno") else None
-                    semgrep_evidence = self._extract_semgrep_evidence(
-                        semgrep_findings, node.name, class_start_line, class_end_line
-                    )
-
-                    # Create feature with Semgrep evidence included in confidence calculation
-                    feature = self._extract_feature_from_class_parallel(
-                        node, file_path, current_count, semgrep_evidence
-                    )
-                    if feature:
-                        # Enhance feature with detailed Semgrep findings (outcomes, constraints, themes)
-                        self._enhance_feature_with_semgrep(
-                            feature, semgrep_findings, file_path, node.name, class_start_line, class_end_line
-                        )
+                    feature = self._extract_feature_for_results(node, file_path, semgrep_findings)
+                    if feature is not None:
                         results["features"].append(feature)
 
         except (SyntaxError, UnicodeDecodeError):
@@ -672,6 +654,31 @@ class CodeAnalyzer:
 
         return results
 
+    def _extract_feature_for_results(
+        self,
+        node: ast.ClassDef,
+        file_path: Path,
+        semgrep_findings: list[dict[str, Any]],
+    ) -> Feature | None:
+        """Extract one feature while isolating per-class enhancement failures."""
+        current_count = 0 if self.key_format == "sequential" else len(self.features)
+        class_start_line = node.lineno if hasattr(node, "lineno") else None
+        class_end_line = node.end_lineno if hasattr(node, "end_lineno") else None
+        semgrep_evidence = self._extract_semgrep_evidence(semgrep_findings, node.name, class_start_line, class_end_line)
+
+        feature = self._extract_feature_from_class_parallel(node, file_path, current_count, semgrep_evidence)
+        if feature is None:
+            return None
+
+        try:
+            self._enhance_feature_with_semgrep(
+                feature, semgrep_findings, file_path, node.name, class_start_line, class_end_line
+            )
+        except Exception as exc:
+            console.print(f"[dim]⚠ Warning: Skipped Semgrep enhancement for {file_path}:{node.name}: {exc}[/dim]")
+
+        return feature
+
     def _merge_analysis_results(self, results: dict[str, Any]) -> None:
         """Merge parallel analysis results into instance variables."""
         # Merge themes
@@ -1327,10 +1334,16 @@ class CodeAnalyzer:
         if not methods:
             return None, None
         primary_method = methods[0]
-        scenarios = self.control_flow_analyzer.extract_scenarios_from_method(
-            primary_method, class_name, primary_method.name
-        )
-        contracts = self.contract_extractor.extract_function_contracts(primary_method)
+        try:
+            scenarios = self.control_flow_analyzer.extract_scenarios_from_method(
+                primary_method, class_name, primary_method.name
+            )
+        except Exception:
+            scenarios = None
+        try:
+            contracts = self.contract_extractor.extract_function_contracts(primary_method)
+        except Exception:
+            contracts = None
         return scenarios, contracts
 
     def _generate_story_title(self, group_name: str, class_name: str) -> str:

{specfact_cli-0.42.3 → specfact_cli-0.42.4}/src/specfact_cli/modules/init/module-package.yaml

@@ -1,5 +1,5 @@
 name: init
-version: 0.1.10
+version: 0.1.13
 commands:
   - init
 category: core
@@ -17,5 +17,5 @@ publisher:
 description: Initialize SpecFact workspace and bootstrap local configuration.
 license: Apache-2.0
 integrity:
-  checksum: sha256:e95ce8c81cc16aac931b977f78c0e4652a68f3d2e81aa09ce496d4753698d231
-  signature: UaFkWSDeevp4et+OM5aKrEk2E+lnTP3idTJg1K0tmFn8bF9tgU1fnnswKSQtn1wL6VEP8lv7XIDxeKxVZP2SDg==
+  checksum: sha256:4f929d90edc481d21cf1aa9c2782f569a34baf560e25d3317067f1c5951509e9
+  signature: Sa60QWb6UaZRp40885CzkWMCGwT809/qQj1dnWIJcocwfLwT7Je+BR2STbGQv2RbTbTBBXmQ0Qwj/+AM3U0qAA==

{specfact_cli-0.42.3 → specfact_cli-0.42.4}/src/specfact_cli/modules/init/src/commands.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 import subprocess
 from pathlib import Path
-from typing import Any
+from typing import Any, cast
 
 import click
 import typer
@@ -23,14 +23,16 @@ from specfact_cli.registry.help_cache import run_discovery_and_write_cache
 from specfact_cli.registry.module_installer import USER_MODULES_ROOT as INIT_USER_MODULES_ROOT
 from specfact_cli.registry.module_packages import get_discovered_modules_for_state
 from specfact_cli.registry.module_state import write_modules_state
-from specfact_cli.runtime import debug_log_operation, debug_print, is_debug_mode, is_non_interactive
+from specfact_cli.runtime import debug_print, is_non_interactive
 from specfact_cli.telemetry import telemetry
+from specfact_cli.utils.contract_predicates import repo_path_exists, repo_path_is_dir
 from specfact_cli.utils.env_manager import EnvManager, EnvManagerInfo, build_tool_command, detect_env_manager
 from specfact_cli.utils.ide_setup import (
     IDE_CONFIG,
-    SPECFACT_COMMANDS,
-    copy_templates_to_ide,
+    _copy_template_files_to_ide,
+    _discover_module_resource_dirs,
     detect_ide,
+    discover_prompt_template_files,
     find_package_resources_path,
 )
 
@@ -49,8 +51,36 @@ install_bundles_for_init = first_run_selection.install_bundles_for_init
 is_first_run = first_run_selection.is_first_run
 
 
+@beartype
+@require(repo_path_exists, "Repo path must exist")
+@require(repo_path_is_dir, "Repo path must be a directory")
+@require(lambda ide: ide in IDE_CONFIG, "IDE must be valid")
+@ensure(
+    lambda result: (
+        isinstance(result, tuple)
+        and len(result) == 2
+        and isinstance(result[0], list)
+        and all(isinstance(path, Path) for path in result[0])
+        and (result[1] is None or isinstance(result[1], Path))
+    ),
+    "Must return copied files and optional settings path",
+)
+def copy_templates_to_ide(repo_path: Path, ide: str, force: bool = False) -> tuple[list[Path], Path | None]:
+    """Compatibility wrapper that discovers prompt templates before copying them."""
+    return _copy_template_files_to_ide(repo_path, ide, discover_prompt_template_files(repo_path), force)
+
+
 def _resolve_field_mapping_templates_dir(repo_path: Path) -> Path | None:
     """Locate backlog field mapping templates (dev checkout or installed package)."""
+    for resource_root in _discover_module_resource_dirs(
+        "resources/templates/backlog/field_mappings",
+        repo_path=repo_path,
+        categories={"backlog"},
+    ):
+        installed_templates_dir = (resource_root / "templates" / "backlog" / "field_mappings").resolve()
+        if installed_templates_dir.exists():
+            return installed_templates_dir
+
     dev_templates_dir = (repo_path / "resources" / "templates" / "backlog" / "field_mappings").resolve()
     if dev_templates_dir.exists():
         return dev_templates_dir
@@ -161,7 +191,8 @@ def _questionary_style() -> Any:
         import questionary  # type: ignore[reportMissingImports]
     except ImportError:
         return None
-    return questionary.Style(
+    questionary_module = cast(Any, questionary)
+    return questionary_module.Style(
         [
             ("qmark", "fg:#00af87 bold"),
             ("question", "bold"),
@@ -214,12 +245,16 @@ def _run_module_checkbox_prompt(
 ) -> list[str]:
     action_title = "Enable" if action == "enable" else "Disable"
     current_state = "disabled" if action == "enable" else "enabled"
-    selected: list[str] | None = questionary.checkbox(
-        f"{action_title} module(s) from currently {current_state}:",
-        choices=choices,
-        instruction="(multi-select)",
-        style=_questionary_style(),
-    ).ask()
+    selected: list[str] | None = (
+        cast(Any, questionary)
+        .checkbox(
+            f"{action_title} module(s) from currently {current_state}:",
+            choices=choices,
+            instruction="(multi-select)",
+            style=_questionary_style(),
+        )
+        .ask()
+    )
     if not selected:
         return []
     return [display_to_id[s] for s in selected if s in display_to_id]
@@ -261,46 +296,35 @@ 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)
+    if prompt_files:
+        return prompt_files[0].parent
+
     dev_templates_dir = (repo_path / "resources" / "prompts").resolve()
     if dev_templates_dir.exists():
         return dev_templates_dir
-    try:
-        import importlib.resources
 
-        resources_ref = importlib.resources.files("specfact_cli")
-        templates_ref = resources_ref / "resources" / "prompts"
-        package_templates_dir = Path(str(templates_ref)).resolve()
-        if package_templates_dir.exists():
-            return package_templates_dir
-    except Exception as exc:
-        if is_debug_mode():
-            debug_log_operation(
-                "template_resolution",
-                "importlib.resources(specfact_cli/resources/prompts)",
-                "error",
-                error=repr(exc),
-            )
     return find_package_resources_path("specfact_cli", "resources/prompts")
 
 
-def _expected_ide_prompt_basenames(format_type: str) -> list[str]:
+def _expected_ide_prompt_basenames(repo_path: Path, format_type: str) -> list[str]:
+    prompt_files = discover_prompt_template_files(repo_path)
     if format_type == "prompt.md":
-        return [f"{cmd}.prompt.md" for cmd in SPECFACT_COMMANDS]
+        return [f"{path.stem}.prompt.md" for path in prompt_files]
     if format_type == "toml":
-        return [f"{cmd}.toml" for cmd in SPECFACT_COMMANDS]
-    return [f"{cmd}.md" for cmd in SPECFACT_COMMANDS]
+        return [f"{path.stem}.toml" for path in prompt_files]
+    return [path.name for path in prompt_files]
 
 
-def _count_outdated_ide_prompts(ide_dir: Path, templates_dir: Path, format_type: str) -> int:
+def _count_outdated_ide_prompts(ide_dir: Path, prompt_files: list[Path], format_type: str) -> int:
     outdated = 0
-    for cmd in SPECFACT_COMMANDS:
-        src = templates_dir / f"{cmd}.md"
+    for src in prompt_files:
         if format_type == "prompt.md":
-            dest = ide_dir / f"{cmd}.prompt.md"
+            dest = ide_dir / f"{src.stem}.prompt.md"
         elif format_type == "toml":
-            dest = ide_dir / f"{cmd}.toml"
+            dest = ide_dir / f"{src.stem}.toml"
         else:
-            dest = ide_dir / f"{cmd}.md"
+            dest = ide_dir / src.name
         if src.exists() and dest.exists() and dest.stat().st_mtime < src.stat().st_mtime:
             outdated += 1
     return outdated
@@ -312,7 +336,7 @@ def _audit_prompt_installation(repo_path: Path) -> None:
     config = IDE_CONFIG[detected_ide]
     ide_dir = repo_path / str(config["folder"])
     format_type = str(config["format"])
-    expected_files = _expected_ide_prompt_basenames(format_type)
+    expected_files = _expected_ide_prompt_basenames(repo_path, format_type)
 
     if not ide_dir.exists():
         console.print(
@@ -322,8 +346,8 @@ def _audit_prompt_installation(repo_path: Path) -> None:
         return
 
     missing = [name for name in expected_files if not (ide_dir / name).exists()]
-    templates_dir = _resolve_templates_dir(repo_path)
-    outdated = _count_outdated_ide_prompts(ide_dir, templates_dir, format_type) if templates_dir else 0
+    prompt_files = discover_prompt_template_files(repo_path)
+    outdated = _count_outdated_ide_prompts(ide_dir, prompt_files, format_type) if prompt_files else 0
 
     if not missing and outdated == 0:
         console.print(f"[green]Prompt status:[/green] {detected_ide} prompts are present and up to date.")
@@ -362,12 +386,16 @@ def _select_ide_interactive(default_ide: str) -> str:
         choices.append(label)
 
     default_label = next((lbl for lbl, iid in label_to_ide.items() if iid == default_ide), choices[0])
-    selected = questionary.select(
-        "Select IDE for prompt setup",
-        choices=choices,
-        default=default_label,
-        style=_questionary_style(),
-    ).ask()
+    selected = (
+        cast(Any, questionary)
+        .select(
+            "Select IDE for prompt setup",
+            choices=choices,
+            default=default_label,
+            style=_questionary_style(),
+        )
+        .ask()
+    )
     if not selected:
         raise typer.Exit(1)
     console.print(Rule(style="dim"))
@@ -441,11 +469,15 @@ def _manual_bundle_ids_from_questionary(questionary: Any) -> list[str]:
         f"{first_run_selection.BUNDLE_DISPLAY.get(bid, bid)}  [dim]({bid})[/dim]"
         for bid in first_run_selection.CANONICAL_BUNDLES
     ]
-    selected = questionary.checkbox(
-        "Select bundles to install:",
-        choices=bundle_choices,
-        style=_questionary_style(),
-    ).ask()
+    selected = (
+        cast(Any, questionary)
+        .checkbox(
+            "Select bundles to install:",
+            choices=bundle_choices,
+            style=_questionary_style(),
+        )
+        .ask()
+    )
     if not selected:
         return []
     return [bid for bid in first_run_selection.CANONICAL_BUNDLES if any(bid in s for s in selected)]
@@ -489,11 +521,15 @@ def _interactive_first_run_bundle_selection() -> list[str]:
     profile_to_key = {f"{label}  [dim]({key})[/dim]": key for key, label in first_run_selection.PROFILE_DISPLAY_ORDER}
     profile_to_key["Choose bundles manually"] = "_manual_"
 
-    choice = questionary.select(
-        "Select a profile or choose bundles manually:",
-        choices=[*profile_choices, "Choose bundles manually"],
-        style=_questionary_style(),
-    ).ask()
+    choice = (
+        cast(Any, questionary)
+        .select(
+            "Select a profile or choose bundles manually:",
+            choices=[*profile_choices, "Choose bundles manually"],
+            style=_questionary_style(),
+        )
+        .ask()
+    )
 
     if not choice:
         return []
@@ -559,13 +595,14 @@ def init_ide(
     if install_deps:
         _install_contract_enhancement_dependencies(repo_path, env_info)
 
-    templates_dir = _resolve_templates_dir(repo_path)
-    if not templates_dir or not templates_dir.exists():
+    prompt_files = discover_prompt_template_files(repo_path)
+    if not prompt_files:
         console.print("[red]Error:[/red] Templates directory not found.")
         raise typer.Exit(1)
 
-    console.print(f"[cyan]Templates:[/cyan] {templates_dir}")
-    copied_files, settings_path = copy_templates_to_ide(repo_path, selected_ide, templates_dir, force)
+    template_sources = ", ".join(sorted({str(path.parent) for path in prompt_files}))
+    console.print(f"[cyan]Templates:[/cyan] {template_sources}")
+    copied_files, settings_path = copy_templates_to_ide(repo_path, selected_ide, force)
     _copy_backlog_field_mapping_templates(repo_path, force, console)
 
     console.print()

{specfact_cli-0.42.3 → specfact_cli-0.42.4}/src/specfact_cli/registry/module_packages.py

@@ -578,7 +578,14 @@ def _make_package_loader(package_dir: Path, package_name: str, command_name: str
             raise ValueError(f"Cannot load from {package_dir.name}")
         mod = importlib.util.module_from_spec(spec)
         sys.modules[spec.name] = mod
-        spec.loader.exec_module(mod)
+        try:
+            spec.loader.exec_module(mod)
+        except (ImportError, ModuleNotFoundError, OSError) as exc:
+            raise ValueError(
+                "Runtime compatibility error while loading "
+                f"module '{package_name}' command '{command_name}' from {package_dir}: {exc}. "
+                f"Reinstall the module and run SpecFact with the same Python interpreter ({sys.executable})."
+            ) from exc
         command_attr = f"{_normalized_module_name(command_name)}_app"
         app = getattr(mod, command_attr, None)
         if app is None:

{specfact_cli-0.42.3 → specfact_cli-0.42.4}/src/specfact_cli/runtime.py

@@ -28,7 +28,7 @@ from specfact_cli.common.logger_setup import (
 )
 from specfact_cli.modes import OperationalMode
 from specfact_cli.utils.structured_io import StructuredFormat
-from specfact_cli.utils.terminal import detect_terminal_capabilities, get_console_config
+from specfact_cli.utils.terminal import detect_terminal_capabilities, ensure_output_stream_safety, get_console_config
 
 
 DEBUG_LOG_DATEFMT = "%Y-%m-%d %H:%M:%S"
@@ -201,6 +201,7 @@ def get_configured_console() -> Console:
     (e.g. CliRunner's captured stdout after invoke() ends).
     """
     mode = get_terminal_mode()
+    ensure_output_stream_safety()
 
     if _is_test_env():
         config = get_console_config()