specfact-cli 0.43.3__tar.gz → 0.44.0__tar.gz

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfact-cli
-Version: 0.43.3
+Version: 0.44.0
 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

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "specfact-cli"
-version = "0.43.3"
+version = "0.44.0"
 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.43.3 → specfact_cli-0.44.0}/src/specfact_cli/__init__.py

@@ -45,6 +45,6 @@ def _bootstrap_bundle_paths() -> None:
 
 _bootstrap_bundle_paths()
 
-__version__ = "0.43.3"
+__version__ = "0.44.0"
 
 __all__ = ["__version__"]

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/adapters/speckit.py

@@ -426,7 +426,7 @@ class SpecKitAdapter(BridgeAdapter):
                 )
                 if title_match:
                     feature_title = title_match.group(1).strip()
-            except Exception:
+            except (OSError, UnicodeDecodeError):
                 pass
         if not feature_title or feature_title.strip() == "":
             return "Unknown Feature"

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/agents/analyze_agent.py

@@ -262,7 +262,7 @@ Focus on semantic understanding, not just structural parsing. Generate the plan
                 try:
                     content = dep_file.read_text(encoding="utf-8")[:500]
                     dependencies.append(f"{dep_file.name}: {content[:100]}...")
-                except Exception:
+                except (OSError, UnicodeDecodeError):
                     pass
         return dependencies
 

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/analyzers/ambiguity_scanner.py

@@ -772,7 +772,7 @@ class AmbiguityScanner:
                     continue
                 if user_clean and len(user_clean) > 2 and user_lower not in excluded and len(user_clean.split()) <= 3:
                     result.add(user_clean.title())
-        except Exception:
+        except (OSError, UnicodeDecodeError, re.error):
             pass
         return result
 
@@ -898,9 +898,9 @@ class AmbiguityScanner:
                         continue
                     try:
                         self._personas_from_py_file(py_file, result, excluded)
-                    except Exception:
+                    except (OSError, UnicodeDecodeError, re.error):
                         continue
-        except Exception:
+        except (OSError, UnicodeDecodeError, re.error):
             pass
         return result
 

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/analyzers/code_analyzer.py

@@ -1794,14 +1794,14 @@ class CodeAnalyzer:
             for commit in commits:
                 try:
                     self._process_commit_for_feature_bounds(commit)
-                except Exception:
+                except (OSError, ValueError):
                     # Skip individual commits that fail (corrupted, etc.)
                     continue
 
         except ImportError:
             # GitPython not available, skip
             pass
-        except Exception:
+        except OSError:
             # Git operations failed, skip gracefully
             pass
 

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/analyzers/contract_extractor.py

@@ -240,7 +240,7 @@ class ContractExtractor:
         if hasattr(ast, "unparse"):
             try:
                 return ast.unparse(node)
-            except Exception:
+            except (ValueError, TypeError):
                 pass
 
         # Fallback: manual conversion
@@ -282,7 +282,7 @@ class ContractExtractor:
         if hasattr(ast, "unparse"):
             try:
                 return ast.unparse(node)
-            except Exception:
+            except (ValueError, TypeError):
                 pass
 
         return "..."
@@ -295,7 +295,7 @@ class ContractExtractor:
         if hasattr(ast, "unparse"):
             try:
                 return ast.unparse(node)
-            except Exception:
+            except (ValueError, TypeError):
                 pass
 
         # Fallback: basic conversion

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/analyzers/graph_analyzer.py

@@ -178,7 +178,7 @@ class GraphAnalyzer:
                     edges = future.result()
                     for module_name, matching_module in edges:
                         graph.add_edge(module_name, matching_module)
-                except Exception:
+                except (OSError, RuntimeError):
                     pass
                 completed += 1
                 if progress_callback:
@@ -211,7 +211,7 @@ class GraphAnalyzer:
                             callee_module = self._resolve_module_from_function(callee, python_files)
                             if callee_module and callee_module in graph:
                                 graph.add_edge(module_name, callee_module)
-                except Exception:
+                except (OSError, RuntimeError):
                     pass
                 completed += 1
                 if progress_callback:

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/analyzers/relationship_mapper.py

@@ -306,7 +306,7 @@ class RelationshipMapper:
                 if file_hash:
                     self.analysis_cache[file_hash] = empty_result
                 return (file_key, empty_result)
-        except Exception:
+        except (OSError, PermissionError):
             pass
 
         try:
@@ -354,7 +354,7 @@ class RelationshipMapper:
                         if not f.done():
                             f.cancel()
                     raise
-                except Exception:
+                except (OSError, ValueError):
                     pass
                 completed_count += 1
                 if progress_callback:

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/common/logger_setup.py

@@ -426,11 +426,11 @@ class LoggerSetup:
             log_file_path = os.path.join(logs_dir, log_file)
 
         log_file_dir = os.path.dirname(log_file_path)
-        os.makedirs(log_file_dir, mode=0o777, exist_ok=True)
+        os.makedirs(log_file_dir, mode=0o755, exist_ok=True)
         try:
             with open(log_file_path, "a", encoding="utf-8"):
                 pass
-        except Exception:
+        except OSError:
             pass
 
         try:

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/enrichers/constitution_enricher.py

@@ -145,7 +145,7 @@ class ConstitutionEnricher:
                         # Simple dependency name without version constraints
                         result["technology_stack"].append(dep)
 
-        except Exception:
+        except (OSError, UnicodeDecodeError, ValueError):
             pass  # If parsing fails, return empty result
 
         return result
@@ -190,7 +190,7 @@ class ConstitutionEnricher:
                 else:
                     result["technology_stack"].append(dep)
 
-        except Exception:
+        except (OSError, UnicodeDecodeError, ValueError):
             pass
 
         return result
@@ -235,7 +235,7 @@ class ConstitutionEnricher:
                 users = [u.strip() for u in re.split(r"[,;]", users_text)]
                 result["target_users"] = users[:5]
 
-        except Exception:
+        except (OSError, UnicodeDecodeError, ValueError):
             pass
 
         return result
@@ -265,7 +265,7 @@ class ConstitutionEnricher:
                     # Extract principles from headings and key sections
                     extracted = self._extract_principles_from_markdown(content, rule_file)
                     principles.extend(extracted)
-                except Exception:
+                except (OSError, UnicodeDecodeError, ValueError):
                     pass
 
         return principles
@@ -293,7 +293,7 @@ class ConstitutionEnricher:
                     # Extract quality standards
                     extracted = self._extract_quality_standards(content)
                     standards.extend(extracted)
-                except Exception:
+                except (OSError, UnicodeDecodeError, ValueError):
                     pass
 
         return standards

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/generators/persona_exporter.py

@@ -242,7 +242,7 @@ class PersonaExporter:
                 protocol_data = load_structured_file(protocol_file)
                 protocol_name = protocol_file.stem.replace(".protocol", "")
                 protocols[protocol_name] = protocol_data
-            except Exception:
+            except (OSError, ValueError):
                 pass
         return protocols
 
@@ -267,7 +267,7 @@ class PersonaExporter:
                 contract_data = load_structured_file(contract_file)
                 contract_name = contract_file.stem.replace(".openapi", "").replace(".asyncapi", "")
                 contracts[contract_name] = contract_data
-            except Exception:
+            except (OSError, ValueError):
                 pass
         return contracts
 

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/modules/_bundle_import.py

@@ -19,9 +19,13 @@ def bootstrap_local_bundle_sources(anchor_file: str) -> None:
     anchor = Path(anchor_file).resolve()
     candidates: list[Path] = []
 
-    env_repo = os.environ.get("SPECFACT_CLI_MODULES_REPO")
-    if env_repo:
-        candidates.append(Path(env_repo).expanduser().resolve())
+    for env_name in ("SPECFACT_CLI_MODULES_REPO", "SPECFACT_MODULES_REPO"):
+        env_repo = os.environ.get(env_name)
+        if not env_repo:
+            continue
+        candidate = Path(env_repo).expanduser().resolve()
+        if candidate not in candidates:
+            candidates.append(candidate)
 
     for parent in anchor.parents:
         # Primary dev layout: .../nold-ai/specfact-cli-worktrees/... and sibling specfact-cli-modules

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/modules/init/module-package.yaml

@@ -1,5 +1,5 @@
 name: init
-version: 0.1.19
+version: 0.1.21
 commands:
   - init
 category: core
@@ -17,5 +17,5 @@ publisher:
 description: Initialize SpecFact workspace and bootstrap local configuration.
 license: Apache-2.0
 integrity:
-  checksum: sha256:a0ca0fb136f278a11a113be78047c3c7037de9a393c27f8e677a26c4ab2ba659
-  signature: r3czsyG/tinaxMTd/lNkhjXQqRUU0ecLywXt1iDWPO0QuExVM+msp5tuAud03QPnuCsMXNdyBWWSDBovPeY+Aw==
+  checksum: sha256:925fd303b581441618597b5fa5d7f308cbc31405455ae7811243c072616974bf
+  signature: uMDekXAxcKEDb8V1rqEeL8X806bP4otT5rT5ShXFlUNjcJ06c90s7xg1KqTNYj/eVsuh07xKSGnWKo1BG6juAw==

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/modules/init/src/commands.py

@@ -13,7 +13,6 @@ from icontract import ensure, require
 from rich.console import Console
 from rich.panel import Panel
 from rich.rule import Rule
-from rich.table import Table
 
 from specfact_cli import __version__
 from specfact_cli.contracts.module_interface import ModuleIOContract
@@ -222,21 +221,6 @@ def _questionary_style() -> Any:
     )
 
 
-def _render_modules_table(modules_list: list[dict[str, Any]]) -> None:
-    """Render discovered modules with effective enabled/disabled state."""
-    table = Table(title="Installed Modules")
-    table.add_column("Module", style="cyan")
-    table.add_column("Version", style="magenta")
-    table.add_column("State", style="green")
-    for module in modules_list:
-        module_id = str(module.get("id", ""))
-        version = str(module.get("version", ""))
-        enabled = bool(module.get("enabled", True))
-        state = "enabled" if enabled else "disabled"
-        table.add_row(module_id, version, state)
-    console.print(table)
-
-
 def _module_checkbox_rows(candidates: list[dict[str, Any]]) -> tuple[dict[str, str], list[str]]:
     display_to_id: dict[str, str] = {}
     choices: list[str] = []
@@ -274,40 +258,6 @@ def _run_module_checkbox_prompt(
     return [display_to_id[s] for s in selected if s in display_to_id]
 
 
-def _select_module_ids_interactive(action: str, modules_list: list[dict[str, Any]]) -> list[str]:
-    """Select one or more module IDs interactively via arrow-key checkbox menu."""
-    try:
-        import questionary  # type: ignore[reportMissingImports]
-    except ImportError as e:
-        console.print(
-            "[red]Interactive module selection requires 'questionary'. Install with: pip install questionary[/red]"
-        )
-        raise typer.Exit(1) from e
-
-    target_enabled = action == "disable"
-    candidates = [m for m in modules_list if bool(m.get("enabled", True)) is target_enabled]
-    if not candidates:
-        console.print(f"[yellow]No modules available to {action}.[/yellow]")
-        return []
-
-    action_title = "Enable" if action == "enable" else "Disable"
-    current_state = "disabled" if action == "enable" else "enabled"
-    console.print()
-    console.print(
-        Panel(
-            f"[bold cyan]{action_title} Modules[/bold cyan]\n"
-            f"Choose one or more currently [bold]{current_state}[/bold] modules.",
-            border_style="cyan",
-        )
-    )
-    console.print(
-        "[dim]Controls: ↑↓ navigate • Space toggle • Enter confirm • Type to search/filter • Ctrl+C cancel[/dim]"
-    )
-
-    display_to_id, choices = _module_checkbox_rows(candidates)
-    return _run_module_checkbox_prompt(action, display_to_id, choices, questionary)
-
-
 def _resolve_templates_dir(repo_path: Path) -> Path | None:
     """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)

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/modules/module_io_shim.py

@@ -17,10 +17,6 @@ def _import_source_exists(source: Path) -> bool:
     return source.exists()
 
 
-def _export_target_exists(target: Path) -> bool:
-    return target.exists()
-
-
 def _external_source_nonempty(external_source: str) -> bool:
     return len(external_source.strip()) > 0
 

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/registry/bootstrap.py

@@ -41,7 +41,7 @@ def _get_category_grouping_enabled() -> bool:
                 return val
             if isinstance(val, str):
                 return val.strip().lower() in ("1", "true", "yes")
-    except Exception:
+    except (OSError, ValueError):
         pass
     return True
 

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/registry/module_packages.py

@@ -742,25 +742,6 @@ def _check_protocol_compliance(module_class: Any) -> list[str]:
     return operations
 
 
-@beartype
-@require(lambda package_name: cast(str, package_name).strip() != "", "Package name must not be empty")
-@ensure(lambda result: result is not None, "Protocol inspection target must be resolved")
-def _resolve_protocol_target(module_obj: Any, package_name: str) -> Any:
-    """Resolve runtime interface used for protocol inspection."""
-    runtime_interface = getattr(module_obj, "runtime_interface", None)
-    if runtime_interface is not None:
-        return runtime_interface
-    commands_interface = getattr(module_obj, "commands", None)
-    if commands_interface is not None:
-        return commands_interface
-    # Module app entrypoints often only expose `app`; load module-local commands for protocol detection.
-    try:
-        return importlib.import_module(f"specfact_cli.modules.{package_name}.src.commands")
-    except Exception:
-        pass
-    return module_obj
-
-
 def _resolve_protocol_source_paths(
     package_dir: Path,
     package_name: str,

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/sync/bridge_sync.py

@@ -67,7 +67,7 @@ def _code_repo_from_cwd(repo_name: str) -> Path | None:
         )
         if result.returncode == 0 and repo_name in result.stdout:
             return cwd
-    except Exception:
+    except (OSError, ValueError):
         pass
     return None
 
@@ -79,7 +79,7 @@ def _code_repo_from_parent(repo_name: str) -> Path | None:
         repo_path = cwd.parent / repo_name
         if repo_path.exists() and (repo_path / ".git").exists():
             return repo_path
-    except Exception:
+    except (OSError, ValueError):
         pass
     return None
 
@@ -94,7 +94,7 @@ def _code_repo_from_grandparent_siblings(repo_name: str) -> Path | None:
         for sibling in grandparent.iterdir():
             if sibling.is_dir() and sibling.name == repo_name and (sibling / ".git").exists():
                 return sibling
-    except Exception:
+    except (OSError, ValueError):
         pass
     return None
 
@@ -1498,7 +1498,7 @@ class BridgeSync:
             parsed_hostname: str | None = cast(str | None, parsed.hostname)
             if parsed_hostname and parsed_hostname.lower() == "dev.azure.com":
                 pass
-        except Exception:
+        except ValueError:
             pass
 
     def _collect_source_tracking_entries_from_proposal_text(self, proposal_content: str) -> list[dict[str, Any]]:

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/sync/spec_to_code.py

@@ -220,7 +220,7 @@ class SpecToCodeSync:
                     data = cast(dict[str, Any], _tomli.load(f))
                     if "project" in data and "dependencies" in data["project"]:
                         dependencies.extend(data["project"]["dependencies"])
-            except Exception:
+            except (ImportError, OSError, ValueError):
                 pass  # Ignore parsing errors
 
         return dependencies

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/utils/context_detection.py

@@ -208,7 +208,7 @@ def _detect_python_framework(repo_path: Path, context: ProjectContext) -> None:
                 context.framework = "flask"
             elif "fastapi" in content:
                 context.framework = "fastapi"
-        except Exception:
+        except (OSError, UnicodeDecodeError):
             pass
 
 
@@ -225,7 +225,7 @@ def _detect_js_framework(repo_path: Path, context: ProjectContext) -> None:
             context.framework = "react"
         elif "vue" in deps:
             context.framework = "vue"
-    except Exception:
+    except (OSError, json.JSONDecodeError):
         pass
 
 

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/utils/progress.py

@@ -45,7 +45,7 @@ def _safe_progress_display(display_console: Console) -> bool:
         # Rich stores active Live displays in Console._live
         if hasattr(display_console, "_live") and display_console._live is not None:
             return False
-    except Exception:
+    except AttributeError:
         pass
 
     return True
@@ -149,7 +149,7 @@ def load_bundle_with_progress(
                 # Brief pause to show completion
                 time.sleep(0.1)
             return bundle
-        except Exception:
+        except (RuntimeError, OSError):
             # If Progress creation fails (e.g., LiveError), fall back to direct load
             pass
 
@@ -222,7 +222,7 @@ def save_bundle_with_progress(
                 # Brief pause to show completion
                 time.sleep(0.1)
             return
-        except Exception:
+        except (RuntimeError, OSError):
             # If Progress creation fails (e.g., LiveError), fall back to direct save
             pass
 

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/utils/progressive_disclosure.py

@@ -82,22 +82,6 @@ def intercept_help_advanced() -> None:
         sys.argv[:] = normalized_args
 
 
-@beartype
-def _is_help_context(ctx: ClickContext | None) -> bool:
-    """Check if this context is for showing help."""
-    if ctx is None:
-        return False
-    # Check if help was requested by looking at params or info_name
-    if hasattr(ctx, "params") and ctx.params:
-        # Check if any help option is in params
-        for param in ctx.params.values() if isinstance(ctx.params, dict) else []:
-            param_name = getattr(param, "name", None)
-            if param_name and param_name in ("--help", "-h", "--help-advanced", "-ha"):
-                return True
-    # Check info_name for help indicators
-    return bool(hasattr(ctx, "info_name") and ctx.info_name and "help" in str(ctx.info_name).lower())
-
-
 @beartype
 def _is_advanced_help_context(ctx: ClickContext | None) -> bool:
     """Check if this context is for showing advanced help."""

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/utils/source_scanner.py

@@ -512,7 +512,7 @@ class SourceArtifactScanner:
                 source_tracking = SourceTracking()
                 source_tracking.update_hash(file_path)
                 file_hashes_cache[rel_path] = source_tracking.file_hashes.get(rel_path, "")
-            except Exception:
+            except (OSError, ValueError):
                 pass
 
     def _index_test_file_for_link_cache(
@@ -552,7 +552,7 @@ class SourceArtifactScanner:
                 source_tracking = SourceTracking()
                 source_tracking.update_hash(file_path)
                 file_hashes_cache[rel_path] = source_tracking.file_hashes.get(rel_path, "")
-            except Exception:
+            except (OSError, ValueError):
                 pass
 
     def _run_parallel_feature_linking(

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/utils/structure.py

@@ -252,7 +252,7 @@ class SpecFactStructure:
                     bundle_dir = base_path / cls.PROJECTS / active_bundle
                     if bundle_dir.exists() and (bundle_dir / "bundle.manifest.yaml").exists():
                         return bundle_dir
-            except Exception:
+            except (OSError, ValueError):
                 # Fallback if config read fails
                 pass
 
@@ -302,7 +302,7 @@ class SpecFactStructure:
                 active_bundle = config.get(cls.ACTIVE_BUNDLE_CONFIG_KEY)
                 if active_bundle:
                     return active_bundle
-            except Exception:
+            except (OSError, ValueError):
                 # Fallback if config read fails
                 pass
 

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/validators/sidecar/dependency_installer.py

@@ -55,7 +55,7 @@ def create_sidecar_venv(venv_path: Path, repo_path: Path) -> bool:
                     if result.returncode == 0:
                         # Venv exists and works, skip recreation
                         return True
-                except Exception:
+                except (OSError, subprocess.SubprocessError):
                     # Venv exists but Python can't run (e.g., libpython issue)
                     # Delete and recreate
                     pass

{specfact_cli-0.43.3 → specfact_cli-0.44.0}/src/specfact_cli/validators/sidecar/orchestrator.py

@@ -51,7 +51,7 @@ def _should_use_progress(console: Console) -> bool:
     try:
         if hasattr(console, "_live") and console._live is not None:
             return False
-    except Exception:
+    except AttributeError:
         pass
     return True