specfact-cli 0.27.0__tar.gz → 0.30.1__tar.gz

{specfact_cli-0.27.0 → specfact_cli-0.30.1}/.gitignore

@@ -107,6 +107,10 @@ docs/internal/
 .github/prompts/specfact.*.md
 .github/prompts/opsx-*.md
 
+.claude/commands/opsx/
+.claude/skills/openspec-*/
+!.claude/skills/openspec-workflows/
+
 # Semgrep rules (generated from tools/semgrep/ - source rules are versioned)
 .semgrep/
 

{specfact_cli-0.27.0 → specfact_cli-0.30.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfact-cli
-Version: 0.27.0
+Version: 0.30.1
 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
@@ -309,12 +309,16 @@ uvx specfact-cli@latest
 pip install -U specfact-cli
 ```
 
-### Initialize IDE Integration (optional but recommended)
+### Bootstrap and IDE Setup
 
 ```bash
+# Bootstrap module registry and local config (~/.specfact)
 specfact init
-specfact init --ide cursor
-specfact init --ide vscode
+
+# Configure IDE prompts/templates (interactive selector by default)
+specfact init ide
+specfact init ide --ide cursor
+specfact init ide --ide vscode
 ```
 
 ### Run Your First Flow
@@ -412,6 +416,49 @@ Most tools help **either** coders **or** agile teams. SpecFact does both:
 - **Backlogs**: GitHub Issues, Azure DevOps, Jira, Linear
 - **Contracts**: Specmatic, OpenAPI
 
+### Module Lifecycle Baseline
+
+SpecFact now has a lifecycle-managed module system:
+
+- `specfact init` is bootstrap-first: initializes local CLI state, discovers installed modules, and reports prompt status.
+- `specfact init ide` handles IDE prompt/template sync and IDE settings updates.
+- `specfact init --list-modules` shows effective enabled/disabled state.
+- `specfact init --enable-module` / `--disable-module` support:
+  - interactive selection in interactive terminals when no module id is provided
+  - explicit ids in non-interactive mode (for automation)
+  - dependency-aware safety checks with `--force` cascading enable/disable behavior
+- Module manifests support dependency and core-version compatibility enforcement at registration time.
+
+This lifecycle model is the baseline for future granular module updates and enhancements. Module installation from third-party or open-source community providers is planned, but not implemented yet.
+
+Contract-first module architecture highlights:
+
+- `ModuleIOContract` formalizes module IO operations (`import`, `export`, `sync`, `validate`) on `ProjectBundle`.
+- Core-module isolation is enforced by static analysis (`core` never imports `specfact_cli.modules.*` directly).
+- Registration tracks protocol operation coverage and schema compatibility metadata.
+- Bridge registry support allows module manifests to declare `service_bridges` converters (for example ADO/Jira/Linear/GitHub) loaded at lifecycle startup without direct core-to-module imports.
+- Protocol reporting classifies modules from effective runtime interfaces with a single aggregate summary (`Full/Partial/Legacy`).
+
+Why this matters:
+
+- Feature areas can evolve independently without repeatedly modifying core CLI wiring.
+- Module teams can ship at different speeds while preserving stable core behavior.
+- Clear IO contracts reduce coupling and make future migrations (e.g., new adapters/modules) lower risk.
+- Core remains focused on lifecycle, registry, and validation orchestration rather than tool-specific command logic.
+
+---
+
+## Developer Note: Command Layout
+
+- Primary command implementations live in `src/specfact_cli/modules/<module>/src/commands.py`.
+- Legacy imports from `src/specfact_cli/commands/*.py` are compatibility shims and only guarantee `app` re-exports.
+- Preferred imports for module code:
+  - `from specfact_cli.modules.<module>.src.commands import app`
+  - `from specfact_cli.modules.<module>.src.commands import <symbol>`
+- Shim deprecation timeline:
+  - Legacy shim usage is deprecated for non-`app` symbols now.
+  - Shim removal is planned no earlier than `v0.30` (or the next major migration window).
+
 ---
 
 ## Where SpecFact Fits

{specfact_cli-0.27.0 → specfact_cli-0.30.1}/README.md

@@ -31,12 +31,16 @@ uvx specfact-cli@latest
 pip install -U specfact-cli
 ```
 
-### Initialize IDE Integration (optional but recommended)
+### Bootstrap and IDE Setup
 
 ```bash
+# Bootstrap module registry and local config (~/.specfact)
 specfact init
-specfact init --ide cursor
-specfact init --ide vscode
+
+# Configure IDE prompts/templates (interactive selector by default)
+specfact init ide
+specfact init ide --ide cursor
+specfact init ide --ide vscode
 ```
 
 ### Run Your First Flow
@@ -134,6 +138,49 @@ Most tools help **either** coders **or** agile teams. SpecFact does both:
 - **Backlogs**: GitHub Issues, Azure DevOps, Jira, Linear
 - **Contracts**: Specmatic, OpenAPI
 
+### Module Lifecycle Baseline
+
+SpecFact now has a lifecycle-managed module system:
+
+- `specfact init` is bootstrap-first: initializes local CLI state, discovers installed modules, and reports prompt status.
+- `specfact init ide` handles IDE prompt/template sync and IDE settings updates.
+- `specfact init --list-modules` shows effective enabled/disabled state.
+- `specfact init --enable-module` / `--disable-module` support:
+  - interactive selection in interactive terminals when no module id is provided
+  - explicit ids in non-interactive mode (for automation)
+  - dependency-aware safety checks with `--force` cascading enable/disable behavior
+- Module manifests support dependency and core-version compatibility enforcement at registration time.
+
+This lifecycle model is the baseline for future granular module updates and enhancements. Module installation from third-party or open-source community providers is planned, but not implemented yet.
+
+Contract-first module architecture highlights:
+
+- `ModuleIOContract` formalizes module IO operations (`import`, `export`, `sync`, `validate`) on `ProjectBundle`.
+- Core-module isolation is enforced by static analysis (`core` never imports `specfact_cli.modules.*` directly).
+- Registration tracks protocol operation coverage and schema compatibility metadata.
+- Bridge registry support allows module manifests to declare `service_bridges` converters (for example ADO/Jira/Linear/GitHub) loaded at lifecycle startup without direct core-to-module imports.
+- Protocol reporting classifies modules from effective runtime interfaces with a single aggregate summary (`Full/Partial/Legacy`).
+
+Why this matters:
+
+- Feature areas can evolve independently without repeatedly modifying core CLI wiring.
+- Module teams can ship at different speeds while preserving stable core behavior.
+- Clear IO contracts reduce coupling and make future migrations (e.g., new adapters/modules) lower risk.
+- Core remains focused on lifecycle, registry, and validation orchestration rather than tool-specific command logic.
+
+---
+
+## Developer Note: Command Layout
+
+- Primary command implementations live in `src/specfact_cli/modules/<module>/src/commands.py`.
+- Legacy imports from `src/specfact_cli/commands/*.py` are compatibility shims and only guarantee `app` re-exports.
+- Preferred imports for module code:
+  - `from specfact_cli.modules.<module>.src.commands import app`
+  - `from specfact_cli.modules.<module>.src.commands import <symbol>`
+- Shim deprecation timeline:
+  - Legacy shim usage is deprecated for non-`app` symbols now.
+  - Shim removal is planned no earlier than `v0.30` (or the next major migration window).
+
 ---
 
 ## Where SpecFact Fits

{specfact_cli-0.27.0 → specfact_cli-0.30.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "specfact-cli"
-version = "0.27.0"
+version = "0.30.1"
 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"
@@ -193,8 +193,8 @@ validate-prompts = "python tools/validate_prompts.py"
 # Development scripts
 test = "pytest {args}"
 test-cov = "pytest --cov=src --cov-report=term-missing {args}"
-type-check = "basedpyright {args}"
-lint = "ruff format . --check && basedpyright && ruff check . && pylint src tests tools"
+type-check = "basedpyright --pythonpath $(python -c 'import sys; print(sys.executable)') {args}"
+lint = "ruff format . --check && basedpyright --pythonpath $(python -c 'import sys; print(sys.executable)') && ruff check . && pylint src tests tools"
 governance = "pylint src tests tools --reports=y --output-format=parseable"
 format = "ruff check . --fix && ruff format ."
 
@@ -705,6 +705,9 @@ ignore = [
 "src/specfact_cli/commands/**/*" = [
     "B008",   # typer.Option/Argument in defaults (common Typer pattern)
 ]
+"src/specfact_cli/modules/**/src/commands.py" = [
+    "B008",   # typer.Option/Argument in defaults (common Typer pattern)
+]
 
 [tool.ruff.lint.isort]
 # Match isort ruff profile configuration

{specfact_cli-0.27.0 → specfact_cli-0.30.1}/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.27.0"
+__version__ = "0.30.1"

{specfact_cli-0.27.0 → specfact_cli-0.30.1}/src/specfact_cli/__init__.py

@@ -8,6 +8,6 @@ This package provides command-line tools for:
 - Supporting agile ceremonies and team workflows
 """
 
-__version__ = "0.27.0"
+__version__ = "0.30.1"
 
 __all__ = ["__version__"]

{specfact_cli-0.27.0 → specfact_cli-0.30.1}/src/specfact_cli/adapters/ado.py

@@ -14,7 +14,7 @@ import os
 import re
 from datetime import UTC, datetime
 from pathlib import Path
-from typing import Any
+from typing import Any, cast
 from urllib.parse import urlparse
 
 import requests
@@ -549,7 +549,15 @@ class AdoAdapter(BridgeAdapter, BacklogAdapterMixin, BacklogAdapter):
         assigned_to = fields.get("System.AssignedTo")
         if assigned_to:
             if isinstance(assigned_to, dict):
-                assignee_name = assigned_to.get("displayName") or assigned_to.get("uniqueName", "")
+                assignee_dict = cast(dict[str, Any], assigned_to)
+                display_name = assignee_dict.get("displayName")
+                unique_name = assignee_dict.get("uniqueName")
+                if isinstance(display_name, str) and display_name.strip():
+                    assignee_name = display_name.strip()
+                elif isinstance(unique_name, str):
+                    assignee_name = unique_name
+                else:
+                    assignee_name = ""
             else:
                 assignee_name = str(assigned_to)
             if assignee_name and not owner:

{specfact_cli-0.27.0 → specfact_cli-0.30.1}/src/specfact_cli/analyzers/graph_analyzer.py

@@ -370,11 +370,11 @@ class GraphAnalyzer:
 
         Tries multiple strategies:
         1. Exact match
-        2. Last part match (e.g., "import_cmd" matches "src.specfact_cli.commands.import_cmd")
-        3. Partial path match (e.g., "specfact_cli.commands" matches "src.specfact_cli.commands.import_cmd")
+        2. Last part match (e.g., "import_cmd" matches "src.specfact_cli.modules.import_cmd.src.commands")
+        3. Partial path match (e.g., "specfact_cli.commands" matches "src.specfact_cli.modules.import_cmd.src.commands")
 
         Args:
-            imported: Imported module name (e.g., "specfact_cli.commands.import_cmd")
+            imported: Imported module name (e.g., "specfact_cli.modules.import_cmd.src.commands")
             known_modules: List of known module names in the graph
 
         Returns:
@@ -385,14 +385,14 @@ class GraphAnalyzer:
             return imported
 
         # Strategy 2: Last part match
-        # e.g., "import_cmd" matches "src.specfact_cli.commands.import_cmd"
+        # e.g., "import_cmd" matches "src.specfact_cli.modules.import_cmd.src.commands"
         imported_last = imported.split(".")[-1]
         for module in known_modules:
             if module.endswith(f".{imported_last}") or module == imported_last:
                 return module
 
         # Strategy 3: Partial path match
-        # e.g., "specfact_cli.commands" matches "src.specfact_cli.commands.import_cmd"
+        # e.g., "specfact_cli.commands" matches "src.specfact_cli.modules.import_cmd.src.commands"
         for module in known_modules:
             # Check if imported is a prefix of module
             if module.startswith(imported + ".") or module == imported:
@@ -406,7 +406,7 @@ class GraphAnalyzer:
         for module in known_modules:
             module_parts = module.split(".")
             # Check if there's overlap in the path
-            # e.g., "commands.import_cmd" might match "src.specfact_cli.commands.import_cmd"
+            # e.g., "commands.import_cmd" might match "src.specfact_cli.modules.import_cmd.src.commands"
             if len(imported_parts) >= 2 and len(module_parts) >= 2 and imported_parts[-2:] == module_parts[-2:]:
                 return module
 

{specfact_cli-0.27.0 → specfact_cli-0.30.1}/src/specfact_cli/cli.py

@@ -257,7 +257,7 @@ def main(
         bool | None,
         typer.Option(
             "--interactive/--no-interactive",
-            help="Force interaction mode (default auto based on CI/CD detection)",
+            help="Force interaction mode (default auto based on terminal/CI detection)",
         ),
     ] = None,
 ) -> None:
@@ -274,6 +274,10 @@ def main(
     - Explicit --mode flag (highest priority)
     - Auto-detect from environment (CoPilot API, IDE integration)
     - Default to CI/CD mode
+
+    Interaction Detection:
+    - Explicit --interactive/--no-interactive (highest priority)
+    - Auto-detect from terminal and CI environment
     """
     global _show_banner
     # Set banner flag based on --banner option
@@ -332,6 +336,33 @@ class _LazyDelegateGroup(click.Group):
     def _make_delegate_command(self) -> click.Command:
         cmd_name = self._lazy_cmd_name
 
+        def _normalize_init_optional_module_flags(argv: list[str]) -> list[str]:
+            """
+            Normalize bare init module flags to sentinel values.
+
+            Typer/Click options declared with value types require an argument. To support
+            UX like `specfact init --enable-module` in interactive mode, rewrite bare flags
+            to include a sentinel token consumed by init command logic.
+            """
+            if cmd_name != "init":
+                return argv
+            out: list[str] = []
+            i = 0
+            while i < len(argv):
+                token = argv[i]
+                if token in ("--enable-module", "--disable-module"):
+                    out.append(token)
+                    if i + 1 < len(argv) and not argv[i + 1].startswith("-"):
+                        out.append(argv[i + 1])
+                        i += 2
+                        continue
+                    out.append("__interactive_select__")
+                    i += 1
+                    continue
+                out.append(token)
+                i += 1
+            return out
+
         def _invoke(args: tuple[str, ...]) -> None:
             from typer.main import get_command
 
@@ -348,6 +379,7 @@ class _LazyDelegateGroup(click.Group):
                 p = getattr(p, "parent", None)
             prog_name = " ".join(reversed(parts)) if parts else cmd_name
             args_list = list(args)
+            args_list = _normalize_init_optional_module_flags(args_list)
             # When the real app is a single command (e.g. drift has only "detect"), Typer
             # builds a TyperCommand, not a Group. Then args are ["detect", "bundle", "--repo", ...]
             # and the command expects ["bundle", "--repo", ...] (no leading "detect").
@@ -503,6 +535,23 @@ def cli_main() -> None:
     # Normalize shell names in argv for Typer's built-in completion commands
     normalize_shell_in_argv()
 
+    # Initialize debug mode early so --debug works even for eager flags like --help/--version.
+    debug_requested = "--debug" in sys.argv[1:]
+    if debug_requested:
+        set_debug_mode(True)
+        init_debug_log_file()
+        debug_log_path = runtime.get_debug_log_path()
+        if debug_log_path:
+            sys.stderr.write(f"[debug] log file: {debug_log_path}\n")
+        else:
+            sys.stderr.write("[debug] log file unavailable (no writable debug log path)\n")
+        runtime.debug_log_operation(
+            "cli_start",
+            "specfact",
+            "started",
+            extra={"argv": sys.argv[1:], "pid": os.getpid()},
+        )
+
     # Check if --banner flag is present (before Typer processes it)
     banner_requested = "--banner" in sys.argv
 

specfact_cli-0.30.1/src/specfact_cli/commands/analyze.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/analyze/."""
+
+from specfact_cli.modules.analyze.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/auth.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/auth/."""
+
+from specfact_cli.modules.auth.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/backlog_commands.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/backlog/."""
+
+from specfact_cli.modules.backlog.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/contract_cmd.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/contract/."""
+
+from specfact_cli.modules.contract.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/drift.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/drift/."""
+
+from specfact_cli.modules.drift.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/enforce.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/enforce/."""
+
+from specfact_cli.modules.enforce.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/generate.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/generate/."""
+
+from specfact_cli.modules.generate.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/import_cmd.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/import_cmd/."""
+
+from specfact_cli.modules.import_cmd.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/init.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/init/."""
+
+from specfact_cli.modules.init.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/migrate.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/migrate/."""
+
+from specfact_cli.modules.migrate.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/plan.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/plan/."""
+
+from specfact_cli.modules.plan.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/project_cmd.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/project/."""
+
+from specfact_cli.modules.project.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/repro.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/repro/."""
+
+from specfact_cli.modules.repro.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/sdd.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/sdd/."""
+
+from specfact_cli.modules.sdd.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/spec.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/spec/."""
+
+from specfact_cli.modules.spec.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/sync.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/sync/."""
+
+from specfact_cli.modules.sync.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/update.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/upgrade/."""
+
+from specfact_cli.modules.upgrade.src.commands import app
+
+
+__all__ = ["app"]

specfact_cli-0.30.1/src/specfact_cli/commands/validate.py

@@ -0,0 +1,6 @@
+"""Backward-compatible app shim. Implementation moved to modules/validate/."""
+
+from specfact_cli.modules.validate.src.commands import app
+
+
+__all__ = ["app"]

{specfact_cli-0.27.0 → specfact_cli-0.30.1}/src/specfact_cli/common/logger_setup.py

@@ -1,5 +1,7 @@
 """
 Logging utility for standardized log setup across all modules
+
+CrossHair: skip (logging internals and logger object realization are not symbolic-safe)
 """
 
 import atexit
@@ -526,8 +528,13 @@ class LoggerSetup:
             queue_handler = QueueHandler(log_queue)
             logger.addHandler(queue_handler)
 
-        # Add a console handler for non-test environments or when no file is specified
-        if "pytest" not in sys.modules and not any(isinstance(h, logging.StreamHandler) for h in logger.handlers):
+        # Add a direct console handler only when no queue listener is active for this logger.
+        # Otherwise logs are already streamed by the QueueListener handler and would be duplicated.
+        if (
+            "pytest" not in sys.modules
+            and logger_name not in cls._log_listeners
+            and not any(isinstance(h, logging.StreamHandler) for h in logger.handlers)
+        ):
             console_handler = logging.StreamHandler(_safe_console_stream())
             console_handler.setFormatter(log_format)
             console_handler.setLevel(level)

specfact_cli-0.30.1/src/specfact_cli/contracts/__init__.py

@@ -0,0 +1,29 @@
+"""Contract exports for protocol and validation integrations.
+
+Keep this package import side-effect free so CrossHair can import
+``specfact_cli.contracts.crosshair_props`` without loading heavy model/utils
+packages that trigger subprocess-based initializers.
+"""
+
+from __future__ import annotations
+
+from importlib import import_module
+from typing import TYPE_CHECKING, Any
+
+
+if TYPE_CHECKING:
+    from specfact_cli.models.validation import ValidationReport
+
+
+__all__ = ["ValidationReport", "crosshair_props"]
+
+
+def __getattr__(name: str) -> Any:
+    """Lazily resolve exported symbols to avoid import-time side effects."""
+    if name == "ValidationReport":
+        from specfact_cli.models.validation import ValidationReport as _ValidationReport
+
+        return _ValidationReport
+    if name == "crosshair_props":
+        return import_module(".crosshair_props", __name__)
+    raise AttributeError(f"module '{__name__}' has no attribute '{name}'")

specfact_cli-0.30.1/src/specfact_cli/contracts/module_interface.py

@@ -0,0 +1,30 @@
+"""Module IO protocol contract for module bundle interactions."""
+
+from __future__ import annotations
+
+from abc import abstractmethod
+from pathlib import Path
+from typing import Any, Protocol
+
+from specfact_cli.models.project import ProjectBundle
+from specfact_cli.models.validation import ValidationReport
+
+
+class ModuleIOContract(Protocol):
+    """Protocol for module implementations that exchange data via ProjectBundle."""
+
+    @abstractmethod
+    def import_to_bundle(self, source: Path, config: dict[str, Any]) -> ProjectBundle:
+        """Import an external artifact and convert it into a ProjectBundle."""
+
+    @abstractmethod
+    def export_from_bundle(self, bundle: ProjectBundle, target: Path, config: dict[str, Any]) -> None:
+        """Export a ProjectBundle to an external artifact format."""
+
+    @abstractmethod
+    def sync_with_bundle(self, bundle: ProjectBundle, external_source: str, config: dict[str, Any]) -> ProjectBundle:
+        """Synchronize a bundle with an external source and return the updated bundle."""
+
+    @abstractmethod
+    def validate_bundle(self, bundle: ProjectBundle, rules: dict[str, Any]) -> ValidationReport:
+        """Run module-specific validation on a ProjectBundle."""

{specfact_cli-0.27.0 → specfact_cli-0.30.1}/src/specfact_cli/generators/persona_exporter.py

@@ -108,7 +108,7 @@ class PersonaExporter:
         Returns:
             Template context dictionary
         """
-        from specfact_cli.commands.project_cmd import match_section_pattern
+        from specfact_cli.utils.persona_ownership import match_section_pattern
 
         context: dict[str, Any] = {
             "bundle_name": bundle.bundle_name,