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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfact-cli
-Version: 0.43.2
+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
@@ -281,9 +281,10 @@ 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 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.
+> **SpecFact is the validation and alignment layer for software delivery.**
+> It adds the missing validation layer that keeps backlog intent, specifications, tests, and code
+> from drifting apart across AI-assisted coding, brownfield systems, and governed delivery.
+> Use it to move fast without losing rigor.
 
 **No API keys required. Works offline. Zero vendor lock-in.**
 
@@ -304,21 +305,54 @@ invoke SpecFact as part of a command chain.
 
 ---
 
-## Documentation Topology
+## What is SpecFact?
 
-`docs.specfact.io` is the canonical docs entry point for SpecFact.
+SpecFact is the validation and alignment layer for software delivery.
 
-- Core CLI/runtime/platform documentation remains owned by `specfact-cli`.
-- Module-specific deep docs are canonically owned by `specfact-cli-modules`.
-- The live modules docs site is currently published at `https://modules.specfact.io/`.
+It is a local CLI that helps you keep the intent behind a change aligned from
+backlog or idea through specifications, implementation, and checks. The “Swiss-knife CLI” metaphor
+fits because SpecFact gives you a set of focused tools for specific delivery problems, not a vague
+bag of features.
 
-Use this repository's docs for the overall SpecFact workflow, CLI runtime lifecycle, module registry, trust model, and command-group topology.
-Use the modules docs site for bundle-specific deep dives, adapter details, workflow tutorials, and module-authoring guidance.
-In short, module-specific deep docs are canonically owned by `specfact-cli-modules`.
+In practice, SpecFact helps you:
+- add guardrails to AI-assisted and fast-moving greenfield work
+- reverse-engineer large brownfield codebases into trustworthy structured understanding
+- reduce the “I wanted X but got Y” drift between backlog, spec, and implementation
+- move from local rigor toward team and enterprise policy enforcement
 
----
+## Why does it exist?
+
+Modern delivery drifts in predictable ways:
+- AI-generated quick wins often lack the validation layer needed for mid- and long-term reliability
+- brownfield systems often have missing or drifted specs, so teams need to reverse-engineer reality
+- backlog intent gets reinterpreted into something else before it reaches code
+- teams working with different skill levels, opinions, and AI IDE setups need consistent review and
+  policy enforcement
+
+SpecFact exists to reduce that drift. It helps teams understand what is really there, express what
+should happen more accurately, and validate that the result still matches the original intent.
+
+## Why should I use it?
+
+Use SpecFact if you want one of these outcomes:
+- ship AI-assisted changes faster without accepting fragile “looks fine to me” quality
+- understand a legacy or unfamiliar codebase before changing it
+- hand brownfield insight into OpenSpec, Spec-Kit, or other spec-first workflows
+- keep backlog expectations, specifications, and implementation from silently diverging
+- enforce shared rules consistently across developers and CI/CD
 
-## Start Here (60 seconds)
+## What do I get?
+
+With SpecFact, you get:
+- a deterministic local CLI instead of another opaque SaaS dependency
+- a validation layer around fast-moving implementation work
+- codebase analysis and sidecar flows for brownfield understanding
+- stronger backlog/spec/code alignment for real delivery workflows
+- a path from individual rigor to organization-level policy enforcement
+
+## How do I get started?
+
+### Start Here (5 minutes)
 
 ### Install
 
@@ -330,38 +364,104 @@ uvx specfact-cli@latest
 pip install -U specfact-cli
 ```
 
-### Bootstrap and IDE Setup
+### Bootstrap
 
 ```bash
-# First run: install official bundles
+# Recommended first run
 specfact init --profile solo-developer
-
-# Alternative bundle selection
-specfact init --install backlog,codebase
-specfact init --install all
-
-# IDE prompt/template setup
-specfact init ide
-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
+### Get First Value
 
 ```bash
-# Analyze an existing codebase
+# Analyze a codebase you care about
 specfact code import my-project --repo .
 
-# Snapshot current project state
+# Snapshot the project state for follow-up workflows
 specfact project snapshot --bundle my-project
 
-# Validate external code without modifying source
+# Validate external code without modifying the target repo
 specfact code validate sidecar init my-project /path/to/repo
 specfact code validate sidecar run my-project /path/to/repo
 ```
 
+That path gives you a concrete first win: SpecFact understands your project context and gives you a
+validated starting point instead of jumping straight into blind change work.
+
+### AI IDE Setup
+
+```bash
+specfact init ide
+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.
+
+## Choose Your Path
+
+### Greenfield and AI-assisted delivery
+
+Use SpecFact as the validation layer around fast-moving implementation work.
+
+Start with:
+- `specfact init --profile solo-developer`
+- `specfact code validate sidecar init <bundle> /path/to/repo`
+- `specfact code validate sidecar run <bundle> /path/to/repo`
+
+### Brownfield and reverse engineering
+
+Use SpecFact to understand an existing system before you change it, then hand that understanding
+into spec-first tools such as OpenSpec or Spec-Kit.
+
+Start with:
+- `specfact code import my-project --repo .`
+- `specfact project snapshot --bundle my-project`
+- `specfact code validate sidecar init my-project /path/to/repo`
+- `specfact code validate sidecar run my-project /path/to/repo`
+
+### Backlog to code alignment
+
+Use SpecFact when the problem is not only code quality, but drift between expectations and delivery.
+Backlog commands require a backlog-enabled profile or installed backlog bundle before the workflow
+commands are available.
+
+Start with:
+- `specfact init --profile backlog-team`
+- `specfact backlog ceremony standup ...`
+- `specfact backlog ceremony refinement ...`
+- `specfact backlog verify-readiness --bundle <bundle-name>`
+
+### Team and policy enforcement
+
+Use SpecFact when multiple developers and AI IDEs need consistent checks and review behavior.
+
+Start with:
+- `specfact backlog verify-readiness --bundle <bundle-name>`
+- `specfact govern ...`
+- CI validation flows that keep the same rules active outside local development
+
+## How do I get started if I want more?
+
+**Next steps**
+
+- **[Core CLI docs](docs/index.md)** for the core runtime, bootstrap, validation, and command topology
+- **[Reference: command topology](docs/reference/commands.md)** for grouped command surfaces
+- **[Canonical modules docs site](https://modules.specfact.io/)** for bundle-deep workflows
+
+## Documentation Topology
+
+`docs.specfact.io` is the canonical starting point for SpecFact.
+
+- Core CLI/runtime/platform documentation remains owned by `specfact-cli`.
+- Module-specific deep docs are canonically owned by `specfact-cli-modules`.
+- The live modules docs site is published at `https://modules.specfact.io/`.
+
+Use this repository's docs for the overall product story, runtime lifecycle, command topology,
+trust model, and getting-started flow. Use the modules docs site when you want deeper workflow,
+adapter, and module-authoring guidance.
+
 ### Migration Note (Flat Commands Removed)
 
 As of `0.40.0`, flat root commands are removed. Use grouped commands:
@@ -401,12 +501,6 @@ For GitHub, replace adapter/org/project with:
 /specfact.01-import my-project --repo .
 ```
 
-**Next steps**
-
-- **[Core CLI docs](docs/index.md)**
-- **[Reference: command topology](docs/reference/commands.md)**
-- **[Canonical modules docs site](https://modules.specfact.io/)**
-
 ---
 
 ## Who It Is For

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

@@ -1,8 +1,9 @@
 # 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 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.
+> **SpecFact is the validation and alignment layer for software delivery.**
+> It adds the missing validation layer that keeps backlog intent, specifications, tests, and code
+> from drifting apart across AI-assisted coding, brownfield systems, and governed delivery.
+> Use it to move fast without losing rigor.
 
 **No API keys required. Works offline. Zero vendor lock-in.**
 
@@ -23,21 +24,54 @@ invoke SpecFact as part of a command chain.
 
 ---
 
-## Documentation Topology
+## What is SpecFact?
 
-`docs.specfact.io` is the canonical docs entry point for SpecFact.
+SpecFact is the validation and alignment layer for software delivery.
 
-- Core CLI/runtime/platform documentation remains owned by `specfact-cli`.
-- Module-specific deep docs are canonically owned by `specfact-cli-modules`.
-- The live modules docs site is currently published at `https://modules.specfact.io/`.
+It is a local CLI that helps you keep the intent behind a change aligned from
+backlog or idea through specifications, implementation, and checks. The “Swiss-knife CLI” metaphor
+fits because SpecFact gives you a set of focused tools for specific delivery problems, not a vague
+bag of features.
 
-Use this repository's docs for the overall SpecFact workflow, CLI runtime lifecycle, module registry, trust model, and command-group topology.
-Use the modules docs site for bundle-specific deep dives, adapter details, workflow tutorials, and module-authoring guidance.
-In short, module-specific deep docs are canonically owned by `specfact-cli-modules`.
+In practice, SpecFact helps you:
+- add guardrails to AI-assisted and fast-moving greenfield work
+- reverse-engineer large brownfield codebases into trustworthy structured understanding
+- reduce the “I wanted X but got Y” drift between backlog, spec, and implementation
+- move from local rigor toward team and enterprise policy enforcement
 
----
+## Why does it exist?
+
+Modern delivery drifts in predictable ways:
+- AI-generated quick wins often lack the validation layer needed for mid- and long-term reliability
+- brownfield systems often have missing or drifted specs, so teams need to reverse-engineer reality
+- backlog intent gets reinterpreted into something else before it reaches code
+- teams working with different skill levels, opinions, and AI IDE setups need consistent review and
+  policy enforcement
+
+SpecFact exists to reduce that drift. It helps teams understand what is really there, express what
+should happen more accurately, and validate that the result still matches the original intent.
+
+## Why should I use it?
+
+Use SpecFact if you want one of these outcomes:
+- ship AI-assisted changes faster without accepting fragile “looks fine to me” quality
+- understand a legacy or unfamiliar codebase before changing it
+- hand brownfield insight into OpenSpec, Spec-Kit, or other spec-first workflows
+- keep backlog expectations, specifications, and implementation from silently diverging
+- enforce shared rules consistently across developers and CI/CD
 
-## Start Here (60 seconds)
+## What do I get?
+
+With SpecFact, you get:
+- a deterministic local CLI instead of another opaque SaaS dependency
+- a validation layer around fast-moving implementation work
+- codebase analysis and sidecar flows for brownfield understanding
+- stronger backlog/spec/code alignment for real delivery workflows
+- a path from individual rigor to organization-level policy enforcement
+
+## How do I get started?
+
+### Start Here (5 minutes)
 
 ### Install
 
@@ -49,38 +83,104 @@ uvx specfact-cli@latest
 pip install -U specfact-cli
 ```
 
-### Bootstrap and IDE Setup
+### Bootstrap
 
 ```bash
-# First run: install official bundles
+# Recommended first run
 specfact init --profile solo-developer
-
-# Alternative bundle selection
-specfact init --install backlog,codebase
-specfact init --install all
-
-# IDE prompt/template setup
-specfact init ide
-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
+### Get First Value
 
 ```bash
-# Analyze an existing codebase
+# Analyze a codebase you care about
 specfact code import my-project --repo .
 
-# Snapshot current project state
+# Snapshot the project state for follow-up workflows
 specfact project snapshot --bundle my-project
 
-# Validate external code without modifying source
+# Validate external code without modifying the target repo
 specfact code validate sidecar init my-project /path/to/repo
 specfact code validate sidecar run my-project /path/to/repo
 ```
 
+That path gives you a concrete first win: SpecFact understands your project context and gives you a
+validated starting point instead of jumping straight into blind change work.
+
+### AI IDE Setup
+
+```bash
+specfact init ide
+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.
+
+## Choose Your Path
+
+### Greenfield and AI-assisted delivery
+
+Use SpecFact as the validation layer around fast-moving implementation work.
+
+Start with:
+- `specfact init --profile solo-developer`
+- `specfact code validate sidecar init <bundle> /path/to/repo`
+- `specfact code validate sidecar run <bundle> /path/to/repo`
+
+### Brownfield and reverse engineering
+
+Use SpecFact to understand an existing system before you change it, then hand that understanding
+into spec-first tools such as OpenSpec or Spec-Kit.
+
+Start with:
+- `specfact code import my-project --repo .`
+- `specfact project snapshot --bundle my-project`
+- `specfact code validate sidecar init my-project /path/to/repo`
+- `specfact code validate sidecar run my-project /path/to/repo`
+
+### Backlog to code alignment
+
+Use SpecFact when the problem is not only code quality, but drift between expectations and delivery.
+Backlog commands require a backlog-enabled profile or installed backlog bundle before the workflow
+commands are available.
+
+Start with:
+- `specfact init --profile backlog-team`
+- `specfact backlog ceremony standup ...`
+- `specfact backlog ceremony refinement ...`
+- `specfact backlog verify-readiness --bundle <bundle-name>`
+
+### Team and policy enforcement
+
+Use SpecFact when multiple developers and AI IDEs need consistent checks and review behavior.
+
+Start with:
+- `specfact backlog verify-readiness --bundle <bundle-name>`
+- `specfact govern ...`
+- CI validation flows that keep the same rules active outside local development
+
+## How do I get started if I want more?
+
+**Next steps**
+
+- **[Core CLI docs](docs/index.md)** for the core runtime, bootstrap, validation, and command topology
+- **[Reference: command topology](docs/reference/commands.md)** for grouped command surfaces
+- **[Canonical modules docs site](https://modules.specfact.io/)** for bundle-deep workflows
+
+## Documentation Topology
+
+`docs.specfact.io` is the canonical starting point for SpecFact.
+
+- Core CLI/runtime/platform documentation remains owned by `specfact-cli`.
+- Module-specific deep docs are canonically owned by `specfact-cli-modules`.
+- The live modules docs site is published at `https://modules.specfact.io/`.
+
+Use this repository's docs for the overall product story, runtime lifecycle, command topology,
+trust model, and getting-started flow. Use the modules docs site when you want deeper workflow,
+adapter, and module-authoring guidance.
+
 ### Migration Note (Flat Commands Removed)
 
 As of `0.40.0`, flat root commands are removed. Use grouped commands:
@@ -120,12 +220,6 @@ For GitHub, replace adapter/org/project with:
 /specfact.01-import my-project --repo .
 ```
 
-**Next steps**
-
-- **[Core CLI docs](docs/index.md)**
-- **[Reference: command topology](docs/reference/commands.md)**
-- **[Canonical modules docs site](https://modules.specfact.io/)**
-
 ---
 
 ## Who It Is For

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "specfact-cli"
-version = "0.43.2"
+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.2 → specfact_cli-0.44.0}/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.43.2"
+__version__ = "0.43.3"

{specfact_cli-0.43.2 → 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.2"
+__version__ = "0.44.0"
 
 __all__ = ["__version__"]

{specfact_cli-0.43.2 → 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.2 → 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.2 → 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.2 → 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.2 → 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.2 → 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.2 → 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.2 → 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.2 → 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.2 → 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