specfact-cli 0.38.2__tar.gz → 0.40.0__tar.gz

{specfact_cli-0.38.2 → specfact_cli-0.40.0}/.gitignore

@@ -106,6 +106,8 @@ docs/internal/
 
 .github/prompts/specfact.*.md
 .github/prompts/opsx-*.md
+.github/skills/openspec-*/
+!.github/skills/openspec-workflows/
 
 .claude/commands/opsx/
 .claude/commands/specfact.*.md

{specfact_cli-0.38.2 → specfact_cli-0.40.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfact-cli
-Version: 0.38.2
+Version: 0.40.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
@@ -313,8 +313,17 @@ pip install -U specfact-cli
 ### Bootstrap and IDE Setup
 
 ```bash
-# Bootstrap module registry and local config (~/.specfact)
-specfact init
+# First run: install workflow bundles (required)
+specfact init --profile solo-developer
+
+# Other first-run options
+specfact init --install backlog,codebase
+specfact init --install all
+
+# First-run bundle selection (examples)
+specfact init --profile solo-developer
+specfact init --install backlog,codebase
+specfact init --install all
 
 # Configure IDE prompts/templates (interactive selector by default)
 specfact init ide
@@ -326,13 +335,21 @@ specfact init ide --ide vscode
 
 ```bash
 # Analyze an existing codebase
-specfact import from-code my-project --repo .
+specfact project import from-code my-project --repo .
 
 # Validate external code without modifying source
-specfact validate sidecar init my-project /path/to/repo
-specfact validate sidecar run my-project /path/to/repo
+specfact code validate sidecar init my-project /path/to/repo
+specfact code validate sidecar run my-project /path/to/repo
 ```
 
+### Migration Note (Flat Commands Removed)
+
+As of `0.40.0`, flat root commands are removed. Use grouped commands:
+
+- `specfact validate ...` -> `specfact code validate ...`
+- `specfact plan ...` -> `specfact project plan ...`
+- `specfact policy ...` -> `specfact backlog policy ...`
+
 ### Backlog Bridge (60 seconds)
 
 SpecFact's USP is closing the drift gap between **backlog -> specs -> code**.
@@ -347,7 +364,7 @@ specfact backlog daily ado --ado-org <org> --ado-project "<project>" --state any
 specfact backlog refine ado --ado-org <org> --ado-project "<project>" --id <work-item-id> --preview
 
 # 3) Keep backlog + spec intent aligned (avoid silent drift)
-specfact policy validate --group-by-item
+specfact backlog policy validate --group-by-item
 ```
 
 For GitHub, replace adapter/org/project with:
@@ -415,8 +432,8 @@ Most tools help **either** coders **or** agile teams. SpecFact does both:
 Recommended command entrypoints:
 - `specfact backlog ceremony standup ...`
 - `specfact backlog ceremony refinement ...`
-- `specfact policy validate ...`
-- `specfact policy suggest ...`
+- `specfact backlog policy validate ...`
+- `specfact backlog policy suggest ...`
 
 What the Policy Engine does in practice:
 - Turns team agreements (DoR, DoD, flow checks) into executable checks against your real backlog data.
@@ -424,9 +441,9 @@ What the Policy Engine does in practice:
 - Generates patch-ready suggestions so teams can fix policy gaps quickly without guessing.
 
 Start with:
-- `specfact policy init --template scrum`
-- `specfact policy validate --group-by-item`
-- `specfact policy suggest --group-by-item --limit 5`
+- `specfact backlog policy init --template scrum`
+- `specfact backlog policy validate --group-by-item`
+- `specfact backlog policy suggest --group-by-item --limit 5`
 
 **Try it now**
 
@@ -437,13 +454,12 @@ Start with:
 
 ## Modules and Capabilities
 
-**Core modules**
+**Core runtime**
 
-- **Analyze**: Extract specs and plans from existing code.
-- **Validate**: Enforce contracts, run reproducible checks, and block regressions.
-- **Report**: CI/CD summaries and evidence outputs.
+- **Permanent commands**: `init`, `module`, `upgrade`
+- **Core responsibilities**: lifecycle, registry, trust, contracts, orchestration, shared runtime utilities
 
-**Agile DevOps modules**
+**Marketplace-installed bundles**
 
 - **Backlog**: Refinement, dependency analysis, sprint summaries, risk rollups.
 - **Ceremony**: Standup, refinement, and planning entry points.
@@ -462,6 +478,41 @@ For technical architecture details (module lifecycle, registry internals, adapte
 - [Architecture Docs Index](docs/architecture/README.md)
 - [Architecture Implementation Status](docs/architecture/implementation-status.md)
 
+### Official Marketplace Bundles
+
+SpecFact ships official bundle packages via the dedicated marketplace registry repository
+`nold-ai/specfact-cli-modules`.
+Bundle-specific docs are still temporarily hosted in this docs set while the long-term
+bundle docs home is prepared in the modules repository docs site:
+`https://nold-ai.github.io/specfact-cli-modules/`.
+
+Install examples:
+
+```bash
+specfact module install nold-ai/specfact-project
+specfact module install nold-ai/specfact-backlog
+specfact module install nold-ai/specfact-codebase
+specfact module install nold-ai/specfact-spec
+specfact module install nold-ai/specfact-govern
+```
+
+If startup warns that bundled modules are missing or outdated, run:
+
+```bash
+specfact module init --scope project
+specfact module init
+```
+
+Official bundles are verified as `official` tier (`nold-ai` publisher). Some bundles
+auto-install dependencies:
+
+- `nold-ai/specfact-spec` pulls `nold-ai/specfact-project`
+- `nold-ai/specfact-govern` pulls `nold-ai/specfact-project`
+
+Use this repo's docs for the current CLI/runtime release branch. Module-specific guides
+will move to `specfact-cli-modules` so future bundle-only changes do not require ongoing
+docs maintenance in long-lived `specfact-cli` release branches.
+
 ---
 
 ## Where SpecFact Fits

{specfact_cli-0.38.2 → specfact_cli-0.40.0}/README.md

@@ -34,8 +34,17 @@ pip install -U specfact-cli
 ### Bootstrap and IDE Setup
 
 ```bash
-# Bootstrap module registry and local config (~/.specfact)
-specfact init
+# First run: install workflow bundles (required)
+specfact init --profile solo-developer
+
+# Other first-run options
+specfact init --install backlog,codebase
+specfact init --install all
+
+# First-run bundle selection (examples)
+specfact init --profile solo-developer
+specfact init --install backlog,codebase
+specfact init --install all
 
 # Configure IDE prompts/templates (interactive selector by default)
 specfact init ide
@@ -47,13 +56,21 @@ specfact init ide --ide vscode
 
 ```bash
 # Analyze an existing codebase
-specfact import from-code my-project --repo .
+specfact project import from-code my-project --repo .
 
 # Validate external code without modifying source
-specfact validate sidecar init my-project /path/to/repo
-specfact validate sidecar run my-project /path/to/repo
+specfact code validate sidecar init my-project /path/to/repo
+specfact code validate sidecar run my-project /path/to/repo
 ```
 
+### Migration Note (Flat Commands Removed)
+
+As of `0.40.0`, flat root commands are removed. Use grouped commands:
+
+- `specfact validate ...` -> `specfact code validate ...`
+- `specfact plan ...` -> `specfact project plan ...`
+- `specfact policy ...` -> `specfact backlog policy ...`
+
 ### Backlog Bridge (60 seconds)
 
 SpecFact's USP is closing the drift gap between **backlog -> specs -> code**.
@@ -68,7 +85,7 @@ specfact backlog daily ado --ado-org <org> --ado-project "<project>" --state any
 specfact backlog refine ado --ado-org <org> --ado-project "<project>" --id <work-item-id> --preview
 
 # 3) Keep backlog + spec intent aligned (avoid silent drift)
-specfact policy validate --group-by-item
+specfact backlog policy validate --group-by-item
 ```
 
 For GitHub, replace adapter/org/project with:
@@ -136,8 +153,8 @@ Most tools help **either** coders **or** agile teams. SpecFact does both:
 Recommended command entrypoints:
 - `specfact backlog ceremony standup ...`
 - `specfact backlog ceremony refinement ...`
-- `specfact policy validate ...`
-- `specfact policy suggest ...`
+- `specfact backlog policy validate ...`
+- `specfact backlog policy suggest ...`
 
 What the Policy Engine does in practice:
 - Turns team agreements (DoR, DoD, flow checks) into executable checks against your real backlog data.
@@ -145,9 +162,9 @@ What the Policy Engine does in practice:
 - Generates patch-ready suggestions so teams can fix policy gaps quickly without guessing.
 
 Start with:
-- `specfact policy init --template scrum`
-- `specfact policy validate --group-by-item`
-- `specfact policy suggest --group-by-item --limit 5`
+- `specfact backlog policy init --template scrum`
+- `specfact backlog policy validate --group-by-item`
+- `specfact backlog policy suggest --group-by-item --limit 5`
 
 **Try it now**
 
@@ -158,13 +175,12 @@ Start with:
 
 ## Modules and Capabilities
 
-**Core modules**
+**Core runtime**
 
-- **Analyze**: Extract specs and plans from existing code.
-- **Validate**: Enforce contracts, run reproducible checks, and block regressions.
-- **Report**: CI/CD summaries and evidence outputs.
+- **Permanent commands**: `init`, `module`, `upgrade`
+- **Core responsibilities**: lifecycle, registry, trust, contracts, orchestration, shared runtime utilities
 
-**Agile DevOps modules**
+**Marketplace-installed bundles**
 
 - **Backlog**: Refinement, dependency analysis, sprint summaries, risk rollups.
 - **Ceremony**: Standup, refinement, and planning entry points.
@@ -183,6 +199,41 @@ For technical architecture details (module lifecycle, registry internals, adapte
 - [Architecture Docs Index](docs/architecture/README.md)
 - [Architecture Implementation Status](docs/architecture/implementation-status.md)
 
+### Official Marketplace Bundles
+
+SpecFact ships official bundle packages via the dedicated marketplace registry repository
+`nold-ai/specfact-cli-modules`.
+Bundle-specific docs are still temporarily hosted in this docs set while the long-term
+bundle docs home is prepared in the modules repository docs site:
+`https://nold-ai.github.io/specfact-cli-modules/`.
+
+Install examples:
+
+```bash
+specfact module install nold-ai/specfact-project
+specfact module install nold-ai/specfact-backlog
+specfact module install nold-ai/specfact-codebase
+specfact module install nold-ai/specfact-spec
+specfact module install nold-ai/specfact-govern
+```
+
+If startup warns that bundled modules are missing or outdated, run:
+
+```bash
+specfact module init --scope project
+specfact module init
+```
+
+Official bundles are verified as `official` tier (`nold-ai` publisher). Some bundles
+auto-install dependencies:
+
+- `nold-ai/specfact-spec` pulls `nold-ai/specfact-project`
+- `nold-ai/specfact-govern` pulls `nold-ai/specfact-project`
+
+Use this repo's docs for the current CLI/runtime release branch. Module-specific guides
+will move to `specfact-cli-modules` so future bundle-only changes do not require ongoing
+docs maintenance in long-lived `specfact-cli` release branches.
+
 ---
 
 ## Where SpecFact Fits

{specfact_cli-0.38.2 → specfact_cli-0.40.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "specfact-cli"
-version = "0.38.2"
+version = "0.40.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"
@@ -234,6 +234,13 @@ smart-test-e2e = "python tools/smart_test_coverage.py run --level e2e {args}"
 smart-test-full = "python tools/smart_test_coverage.py run --level full {args}"
 smart-test-auto = "python tools/smart_test_coverage.py run --level auto {args}"
 
+# Module migration pre-deletion gate
+verify-removal-gate = [
+    "python scripts/verify-bundle-published.py --modules project,plan,import_cmd,sync,migrate,backlog,policy_engine,analyze,drift,validate,repro,contract,spec,sdd,generate,enforce,patch_mode",
+    "python scripts/verify-modules-signature.py --require-signature",
+]
+export-change-github = "python scripts/export-change-to-github.py {args}"
+
 # Contract-First Smart Test System Scripts
 contract-test = "python tools/contract_first_smart_test.py run --level auto {args}"
 contract-test-contracts = "python tools/contract_first_smart_test.py contracts"

{specfact_cli-0.38.2 → specfact_cli-0.40.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.38.2"
+__version__ = "0.40.0"

specfact_cli-0.40.0/src/specfact_cli/__init__.py

@@ -0,0 +1,47 @@
+"""
+SpecFact CLI - The swiss knife CLI for agile DevOps teams.
+
+This package provides command-line tools for:
+- Turning code into clear specs and plans
+- Keeping backlog, specs, tests, and code in sync
+- Enforcing validation and contract checks before production
+- Supporting agile ceremonies and team workflows
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+from pathlib import Path
+
+
+def _candidate_modules_repo_roots() -> list[Path]:
+    configured = os.environ.get("SPECFACT_MODULES_REPO", "").strip()
+    roots: list[Path] = []
+    if configured:
+        roots.append(Path(configured).expanduser())
+
+    this_file = Path(__file__).resolve()
+    for base in (this_file.parent.parent.parent, *this_file.parents):
+        roots.append(base / "specfact-cli-modules")
+        roots.append(base.parent / "specfact-cli-modules")
+    return roots
+
+
+def _bootstrap_bundle_paths() -> None:
+    for root in _candidate_modules_repo_roots():
+        packages_root = root / "packages"
+        if not packages_root.exists():
+            continue
+        for src_dir in packages_root.glob("*/src"):
+            src = str(src_dir.resolve())
+            if src not in sys.path:
+                sys.path.insert(0, src)
+        break
+
+
+_bootstrap_bundle_paths()
+
+__version__ = "0.40.0"
+
+__all__ = ["__version__"]

{specfact_cli-0.38.2 → specfact_cli-0.40.0}/src/specfact_cli/adapters/ado.py

@@ -174,8 +174,8 @@ class AdoAdapter(BridgeAdapter, BacklogAdapterMixin, BacklogAdapter):
                         "[dim]Options:[/dim]\n"
                         "  1. Use a Personal Access Token (PAT) with longer expiration (up to 1 year):\n"
                         "     - Create PAT: https://dev.azure.com/{org}/_usersSettings/tokens\n"
-                        "     - Store PAT: specfact auth azure-devops --pat your_pat_token\n"
-                        "  2. Re-authenticate: specfact auth azure-devops\n"
+                        "     - Store PAT: specfact backlog auth azure-devops --pat your_pat_token\n"
+                        "  2. Re-authenticate: specfact backlog auth azure-devops\n"
                         "  3. Use --ado-token option with a valid token"
                     )
                     self.api_token = None
@@ -792,7 +792,7 @@ class AdoAdapter(BridgeAdapter, BacklogAdapterMixin, BacklogAdapter):
                 "Azure DevOps API token required. Options:\n"
                 "  1. Set AZURE_DEVOPS_TOKEN environment variable\n"
                 "  2. Provide via --ado-token option\n"
-                "  3. Run `specfact auth azure-devops` for device code authentication"
+                "  3. Run `specfact backlog auth azure-devops` for device code authentication"
             )
             raise ValueError(msg)
 
@@ -2898,7 +2898,7 @@ class AdoAdapter(BridgeAdapter, BacklogAdapterMixin, BacklogAdapter):
                 "Options:\n"
                 "  1. Set AZURE_DEVOPS_TOKEN environment variable\n"
                 "  2. Use --ado-token option\n"
-                "  3. Store token via specfact auth azure-devops"
+                "  3. Store token via specfact backlog auth azure-devops"
             )
             raise ValueError(msg)
 

{specfact_cli-0.38.2 → specfact_cli-0.40.0}/src/specfact_cli/adapters/github.py

@@ -648,7 +648,7 @@ class GitHubAdapter(BridgeAdapter, BacklogAdapterMixin, BacklogAdapter):
                 "  2. Provide via --github-token option\n"
                 "  3. Use GitHub CLI: `gh auth login` (auto-detected if available)\n"
                 "  4. Use --use-gh-cli flag to explicitly use GitHub CLI token\n"
-                "  5. Run `specfact auth github` for device code authentication"
+                "  5. Run `specfact backlog auth github` for device code authentication"
             )
             raise ValueError(msg)
 
@@ -1114,7 +1114,7 @@ class GitHubAdapter(BridgeAdapter, BacklogAdapterMixin, BacklogAdapter):
                 "  1. Set GITHUB_TOKEN environment variable\n"
                 "  2. Use --github-token option\n"
                 "  3. Use GitHub CLI authentication (gh auth login)\n"
-                "  4. Store token via specfact auth github"
+                "  4. Store token via specfact backlog auth github"
             )
             raise ValueError(msg)
 

{specfact_cli-0.38.2 → specfact_cli-0.40.0}/src/specfact_cli/cli.py

@@ -66,6 +66,66 @@ from specfact_cli.utils.progressive_disclosure import ProgressiveDisclosureGroup
 from specfact_cli.utils.structured_io import StructuredFormat
 
 
+# Names of commands that come from installable bundles; when not registered, show actionable error.
+KNOWN_BUNDLE_GROUP_OR_SHIM_NAMES: frozenset[str] = frozenset(
+    {
+        "backlog",
+        "code",
+        "project",
+        "spec",
+        "govern",
+        "plan",
+        "validate",
+        "contract",
+        "sdd",
+        "generate",
+        "enforce",
+        "patch",
+        "migrate",
+        "repro",
+        "drift",
+        "analyze",
+        "policy",
+        "import",
+        "sync",
+    }
+)
+
+
+class _RootCLIGroup(ProgressiveDisclosureGroup):
+    """Root group that shows actionable error when an unknown command is a known bundle group/shim."""
+
+    def resolve_command(
+        self, ctx: click.Context, args: list[str]
+    ) -> tuple[str | None, click.Command | None, list[str]]:
+        if not args:
+            return super().resolve_command(ctx, args)
+        invoked = args[0]
+        try:
+            result = super().resolve_command(ctx, args)
+        except click.UsageError:
+            if invoked in KNOWN_BUNDLE_GROUP_OR_SHIM_NAMES:
+                get_configured_console().print(
+                    f"[bold red]Command '{invoked}' is not installed.[/bold red]\n"
+                    "Install workflow bundles with [bold]specfact init --profile <profile>[/bold] "
+                    "or [bold]specfact module install <bundle>[/bold]."
+                )
+                raise SystemExit(1) from None
+            raise
+        _name, cmd, remaining = result
+        if cmd is not None or not remaining:
+            return result
+        invoked = remaining[0]
+        if invoked not in KNOWN_BUNDLE_GROUP_OR_SHIM_NAMES:
+            return result
+        get_configured_console().print(
+            f"[bold red]Command '{invoked}' is not installed.[/bold red]\n"
+            "Install workflow bundles with [bold]specfact init --profile <profile>[/bold] "
+            "or [bold]specfact module install <bundle>[/bold]."
+        )
+        raise SystemExit(1)
+
+
 # Map shell names for completion support
 SHELL_MAP = {
     "sh": "bash",  # sh is bash-compatible
@@ -112,7 +172,7 @@ app = typer.Typer(
     add_completion=True,  # Enable Typer's built-in completion (works natively for bash/zsh/fish without extensions)
     rich_markup_mode="rich",
     context_settings={"help_option_names": ["-h", "--help", "--help-advanced", "-ha"]},  # Add aliases for help
-    cls=ProgressiveDisclosureGroup,  # Use custom group for progressive disclosure
+    cls=_RootCLIGroup,  # Progressive disclosure + actionable error for unknown bundle commands
 )
 
 console = get_configured_console()
@@ -269,6 +329,9 @@ def main(
     Transform your development workflow with automated quality gates,
     runtime contract validation, and state machine workflows.
 
+    Run **specfact init** or **specfact module install** to add workflow bundles
+    (backlog, code, project, spec, govern).
+
     **Backlog Management**: Use `specfact backlog refine` for AI-assisted template-driven
     refinement of backlog items from GitHub Issues, Azure DevOps, and other tools.
 
@@ -451,13 +514,26 @@ def _make_lazy_typer(cmd_name: str, help_str: str) -> typer.Typer:
 
 
 def _get_command(typer_instance: typer.Typer) -> click.Command:
-    """Wrapper around typer.main.get_command that returns LazyDelegateGroup for our lazy typers."""
+    """Wrapper around typer.main.get_command that returns LazyDelegateGroup for our lazy typers,
+    and applies flatten-same-name for Typers with _specfact_flatten_same_name.
+    """
     if getattr(typer_instance, "_specfact_lazy_delegate", False):
         cmd_name = getattr(typer_instance, "_specfact_lazy_cmd_name", "")
         help_str = getattr(typer_instance, "_specfact_lazy_help_str", "")
         return _build_lazy_delegate_group(cmd_name, help_str)
     assert _typer_get_command_original is not None
-    return _typer_get_command_original(typer_instance)
+    result = _typer_get_command_original(typer_instance)
+    flatten_name = getattr(typer_instance, "_specfact_flatten_same_name", None)
+    if isinstance(flatten_name, str) and isinstance(result, click.Group) and flatten_name in result.commands:
+        redundant = result.commands.pop(flatten_name)
+        if isinstance(redundant, click.Group):
+            for cmd_name, cmd in redundant.commands.items():
+                result.add_command(cmd, name=cmd_name)
+        if result.commands:
+            for cname in sorted(result.commands.keys()):
+                cmd = result.commands.pop(cname)
+                result.add_command(cmd, name=cname)
+    return result
 
 
 def _get_group_from_info_wrapper(
@@ -476,12 +552,23 @@ def _get_group_from_info_wrapper(
         help_str = getattr(typer_instance, "_specfact_lazy_help_str", "")
         return _build_lazy_delegate_group(cmd_name, help_str)
     assert _typer_get_group_from_info_original is not None
-    return _typer_get_group_from_info_original(
+    result = _typer_get_group_from_info_original(
         group_info,
         pretty_exceptions_short=pretty_exceptions_short,
         suggest_commands=suggest_commands,
         rich_markup_mode=rich_markup_mode,
     )
+    flatten_name = getattr(typer_instance, "_specfact_flatten_same_name", None) if typer_instance else None
+    if isinstance(flatten_name, str) and flatten_name in result.commands:
+        redundant = result.commands.pop(flatten_name)
+        if isinstance(redundant, click.Group):
+            for cmd_name, cmd in redundant.commands.items():
+                result.add_command(cmd, name=cmd_name)
+        if result.commands:
+            for name in sorted(result.commands.keys()):
+                cmd = result.commands.pop(name)
+                result.add_command(cmd, name=name)
+    return result
 
 
 # Original Typer build functions (set once by _patch_typer_build so re-import of cli doesn't overwrite with our wrapper).

{specfact_cli-0.38.2 → specfact_cli-0.40.0}/src/specfact_cli/commands/__init__.py

@@ -4,30 +4,8 @@ SpecFact CLI commands package.
 This package contains all CLI command implementations.
 """
 
-from specfact_cli.commands import (
-    analyze,
-    auth,
-    contract_cmd,
-    drift,
-    enforce,
-    generate,
-    import_cmd,
-    init,
-    migrate,
-    plan,
-    project_cmd,
-    repro,
-    sdd,
-    spec,
-    sync,
-    update,
-    validate,
-)
-
-
 __all__ = [
     "analyze",
-    "auth",
     "contract_cmd",
     "drift",
     "enforce",
@@ -38,7 +16,6 @@ __all__ = [
     "plan",
     "project_cmd",
     "repro",
-    "run",
     "sdd",
     "spec",
     "sync",

specfact_cli-0.40.0/src/specfact_cli/commands/_bundle_shim.py

@@ -0,0 +1,14 @@
+"""Helpers for lazy-loading compatibility shims that point to bundle packages."""
+
+from __future__ import annotations
+
+from importlib import import_module
+from typing import Any
+
+from ..modules._bundle_import import bootstrap_local_bundle_sources
+
+
+def load_bundle_app(anchor_file: str, target_module: str) -> Any:
+    """Load and return the lazily imported `app` object from a bundle command module."""
+    bootstrap_local_bundle_sources(anchor_file)
+    return import_module(target_module).app

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

@@ -0,0 +1,18 @@
+"""Backward-compatible app shim for code analyze command."""
+
+from typing import TYPE_CHECKING, Any
+
+from ._bundle_shim import load_bundle_app
+
+
+if TYPE_CHECKING:
+    app: Any
+
+
+def __getattr__(name: str) -> Any:
+    if name == "app":
+        return load_bundle_app(__file__, "specfact_codebase.analyze.commands")
+    raise AttributeError(name)
+
+
+__all__ = ["app"]

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

@@ -0,0 +1,18 @@
+"""Backward-compatible app shim for backlog command."""
+
+from typing import TYPE_CHECKING, Any
+
+from ._bundle_shim import load_bundle_app
+
+
+if TYPE_CHECKING:
+    app: Any
+
+
+def __getattr__(name: str) -> Any:
+    if name == "app":
+        return load_bundle_app(__file__, "specfact_backlog.backlog.commands")
+    raise AttributeError(name)
+
+
+__all__ = ["app"]

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

@@ -0,0 +1,18 @@
+"""Backward-compatible app shim for spec contract command."""
+
+from typing import TYPE_CHECKING, Any
+
+from ._bundle_shim import load_bundle_app
+
+
+if TYPE_CHECKING:
+    app: Any
+
+
+def __getattr__(name: str) -> Any:
+    if name == "app":
+        return load_bundle_app(__file__, "specfact_spec.contract.commands")
+    raise AttributeError(name)
+
+
+__all__ = ["app"]