specfact-cli 0.40.4__tar.gz → 0.41.0__tar.gz

{specfact_cli-0.40.4 → specfact_cli-0.41.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfact-cli
-Version: 0.40.4
+Version: 0.41.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
@@ -335,7 +335,7 @@ specfact init ide --ide vscode
 
 ```bash
 # Analyze an existing codebase
-specfact project import from-code my-project --repo .
+specfact code import my-project --repo .
 
 # Validate external code without modifying source
 specfact code validate sidecar init my-project /path/to/repo

{specfact_cli-0.40.4 → specfact_cli-0.41.0}/README.md

@@ -56,7 +56,7 @@ specfact init ide --ide vscode
 
 ```bash
 # Analyze an existing codebase
-specfact project import from-code my-project --repo .
+specfact code import my-project --repo .
 
 # Validate external code without modifying source
 specfact code validate sidecar init my-project /path/to/repo

{specfact_cli-0.40.4 → specfact_cli-0.41.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "specfact-cli"
-version = "0.40.4"
+version = "0.41.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.40.4 → specfact_cli-0.41.0}/resources/prompts/shared/cli-enforcement.md

@@ -109,7 +109,7 @@ When generating or enhancing code via LLM, **ALWAYS** follow this pattern:
 
 - `specfact plan init <bundle-name>` - Initialize project bundle
 - `specfact plan select <bundle-name>` - Set active plan (used as default for other commands)
-- `specfact import from-code [<bundle-name>] --repo <path>` - Import from codebase (uses active plan if bundle not specified)
+- `specfact code import [<bundle-name>] --repo <path>` - Import from codebase (uses active plan if bundle not specified)
 - `specfact plan review [<bundle-name>]` - Review plan (uses active plan if bundle not specified)
 - `specfact plan harden [<bundle-name>]` - Create SDD manifest (uses active plan if bundle not specified)
 - `specfact enforce sdd [<bundle-name>]` - Validate SDD (uses active plan if bundle not specified)

{specfact_cli-0.40.4 → specfact_cli-0.41.0}/resources/prompts/specfact.03-review.md

@@ -318,7 +318,7 @@ specfact plan update-idea --bundle [<bundle-name>] --value-hypothesis "..." --na
 #### Option C: Apply enrichment via import (only if bundle needs regeneration)
 
 ```bash
-specfact import from-code [<bundle-name>] --repo . --enrichment enrichment-report.md
+specfact code import [<bundle-name>] --repo . --enrichment enrichment-report.md
 ```
 
 **Note:**

{specfact_cli-0.40.4 → specfact_cli-0.41.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.40.3"
+__version__ = "0.41.0"

{specfact_cli-0.40.4 → specfact_cli-0.41.0}/src/specfact_cli/__init__.py

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

{specfact_cli-0.40.4 → specfact_cli-0.41.0}/src/specfact_cli/agents/analyze_agent.py

@@ -57,7 +57,7 @@ class AnalyzeAgent(AgentMode):
         Examples:
             >>> agent = AnalyzeAgent()
             >>> prompt = agent.generate_prompt("import from-code", {"current_file": "src/main.py"})
-            >>> "specfact import from-code" in prompt.lower()
+            >>> "specfact code import" in prompt.lower()
             True
         """
         if context is None:
@@ -316,7 +316,7 @@ Dependencies: {len(dependencies)} dependency files found
         **Pragmatic Approach**: This method is designed for AI IDE integration (Cursor, CoPilot, etc.).
         The AI IDE's native LLM will:
         1. Understand the codebase semantically (using the prompt from `generate_prompt()`)
-        2. Call the SpecFact CLI (`specfact import from-code`) for structured analysis
+        2. Call the SpecFact CLI (`specfact code import`) for structured analysis
         3. Enhance results with semantic understanding
 
         This avoids the need for:
@@ -356,7 +356,7 @@ Dependencies: {len(dependencies)} dependency files found
 
         # In AI IDE mode, the AI will:
         # 1. Use the prompt to understand the codebase semantically
-        # 2. Call `specfact import from-code` with appropriate arguments
+        # 2. Call `specfact code import` with appropriate arguments
         # 3. Parse the CLI output and enhance with semantic understanding
         # 4. Present results to the user
 

{specfact_cli-0.40.4 → specfact_cli-0.41.0}/src/specfact_cli/commands/import_cmd.py

@@ -1,4 +1,4 @@
-"""Backward-compatible app shim for project import command."""
+"""Backward-compatible app shim for code-owned import command."""
 
 from typing import TYPE_CHECKING, Any
 
@@ -11,7 +11,7 @@ if TYPE_CHECKING:
 
 def __getattr__(name: str) -> Any:
     if name == "app":
-        return load_bundle_app(__file__, "specfact_project.import_cmd.commands")
+        return load_bundle_app(__file__, "specfact_codebase.import_cmd.commands")
     raise AttributeError(name)
 
 

{specfact_cli-0.40.4 → specfact_cli-0.41.0}/src/specfact_cli/groups/codebase_group.py

@@ -1,4 +1,4 @@
-"""Codebase quality category group (analyze, drift, validate, repro)."""
+"""Codebase category group (import, analyze, drift, validate, repro)."""
 
 from __future__ import annotations
 
@@ -9,7 +9,7 @@ from icontract import ensure, require
 from specfact_cli.registry.registry import CommandRegistry
 
 
-_MEMBERS = ("analyze", "drift", "validate", "repro")
+_MEMBERS = ("import", "analyze", "drift", "validate", "repro")
 
 
 @require(lambda app: app is not None)
@@ -30,7 +30,7 @@ def build_app() -> typer.Typer:
     """Build the code group Typer with members (lazy; registry must be populated)."""
     app = typer.Typer(
         name="code",
-        help="Codebase quality commands: analyze, drift, validate, repro.",
+        help="Codebase commands: import, analyze, drift, validate, repro.",
         no_args_is_help=True,
     )
     _register_members(app)

{specfact_cli-0.40.4 → specfact_cli-0.41.0}/src/specfact_cli/groups/project_group.py

@@ -1,4 +1,4 @@
-"""Project lifecycle category group (project, plan, import, sync, migrate)."""
+"""Project lifecycle category group (project, plan, sync, migrate)."""
 
 from __future__ import annotations
 
@@ -12,7 +12,6 @@ from specfact_cli.registry.registry import CommandRegistry
 _MEMBERS = [
     ("project", "project"),
     ("plan", "plan"),
-    ("import", "import"),
     ("sync", "sync"),
     ("migrate", "migrate"),
 ]

{specfact_cli-0.40.4 → specfact_cli-0.41.0}/src/specfact_cli/utils/structure.py

@@ -945,7 +945,7 @@ See `docs/directory-structure.md` for complete documentation.
 specfact plan init --interactive
 
 # Analyze existing code
-specfact import from-code --repo .
+specfact code import <bundle-name> --repo .
 
 # Compare plans
         specfact plan compare --manual .specfact/plans/main.bundle.yaml --auto .specfact/plans/auto-derived-<timestamp>.bundle.yaml

{specfact_cli-0.40.4 → specfact_cli-0.41.0}/src/specfact_cli/utils/suggestions.py

@@ -38,14 +38,14 @@ def suggest_next_steps(repo_path: Path, context: ProjectContext | None = None) -
 
     # First-time setup suggestions
     if not context.has_plan and not context.has_config:
-        suggestions.append("specfact import from-code --bundle <name>  # Import your codebase")
+        suggestions.append("specfact code import <name> --repo .  # Import your codebase")
         suggestions.append("specfact init  # Initialize SpecFact configuration")
         return suggestions
 
     # Analysis suggestions
     if context.has_plan and context.contract_coverage < 0.5:
         suggestions.append("specfact analyze --bundle <name>  # Analyze contract coverage")
-        suggestions.append("specfact import from-code --bundle <name>  # Update plan from code")
+        suggestions.append("specfact code import <name> --repo .  # Update the project bundle from code")
 
     # Specmatic integration suggestions
     if context.has_specmatic_config and not context.openapi_specs:
@@ -81,7 +81,7 @@ def suggest_fixes(error_message: str, context: ProjectContext | None = None) ->
     # Bundle not found
     if "bundle" in error_lower and ("not found" in error_lower or "does not exist" in error_lower):
         suggestions.append("specfact plan select  # Select an active plan bundle")
-        suggestions.append("specfact import from-code --bundle <name>  # Create a new bundle")
+        suggestions.append("specfact code import <name> --repo .  # Create a new bundle from code")
 
     # Contract validation errors
     if "contract" in error_lower and ("violation" in error_lower or "invalid" in error_lower):
@@ -95,7 +95,7 @@ def suggest_fixes(error_message: str, context: ProjectContext | None = None) ->
 
     # Import errors
     if "import" in error_lower and "failed" in error_lower:
-        suggestions.append("specfact import from-code --bundle <name> --repo .  # Retry import")
+        suggestions.append("specfact code import <name> --repo .  # Retry import")
 
     return suggestions
 
@@ -116,7 +116,7 @@ def suggest_improvements(context: ProjectContext) -> list[str]:
     # Low contract coverage
     if context.contract_coverage < 0.3:
         suggestions.append("specfact analyze --bundle <name>  # Identify missing contracts")
-        suggestions.append("specfact import from-code --bundle <name>  # Extract contracts from code")
+        suggestions.append("specfact code import <name> --repo .  # Extract contracts from code")
 
     # Missing OpenAPI specs
     if context.has_plan and not context.openapi_specs:

{specfact_cli-0.40.4 → specfact_cli-0.41.0}/src/specfact_cli/validation/command_audit.py

@@ -32,6 +32,15 @@ def _resolve_modules_repo_root() -> Path | None:
             return candidate
 
     current = Path(__file__).resolve()
+    current_parts = current.parts
+    if "specfact-cli-worktrees" in current_parts:
+        idx = current_parts.index("specfact-cli-worktrees")
+        worktree_root = Path(*current_parts[:idx], "specfact-cli-modules-worktrees")
+        relative_tail = current.relative_to(Path(*current_parts[: idx + 1]))
+        candidate = worktree_root / relative_tail.parts[0] / relative_tail.parts[1]
+        if candidate.exists():
+            return candidate.resolve()
+
     for parent in current.parents:
         sibling = parent.parent / "specfact-cli-modules"
         if sibling.exists():
@@ -89,6 +98,19 @@ def _collect_typer_paths(app: object, prefix: str) -> set[str]:
     return paths
 
 
+def _auditable_paths_for_prefix(app: object, prefix: str) -> set[str]:
+    """Return help-safe command paths for audit cases.
+
+    `code import` is implemented as a callback-driven command surface with optional
+    positional bundle input plus compatibility subcommands. The canonical audited
+    public path is `code import` itself, not nested help cases under that prefix.
+    """
+    paths = _collect_typer_paths(app, prefix)
+    if prefix == "code":
+        paths = {path for path in paths if not path.startswith("code import ")}
+    return paths
+
+
 def _import_typer(module_path: str, attr_name: str = "app") -> object:
     module = importlib.import_module(module_path)
     return getattr(module, attr_name)
@@ -111,6 +133,13 @@ def _explicit_cases() -> list[CommandAuditCase]:
         CommandAuditCase("project", ("project", "--help"), "project", "help-only", "nold-ai/specfact-project"),
         CommandAuditCase("spec", ("spec", "--help"), "spec", "help-only", "nold-ai/specfact-spec"),
         CommandAuditCase("code", ("code", "--help"), "code", "help-only", "nold-ai/specfact-codebase"),
+        CommandAuditCase(
+            "code import",
+            ("code", "import", "--help"),
+            "code",
+            "help-only",
+            "nold-ai/specfact-codebase",
+        ),
         CommandAuditCase("backlog", ("backlog", "--help"), "backlog", "help-only", "nold-ai/specfact-backlog"),
         CommandAuditCase("govern", ("govern", "--help"), "govern", "help-only", "nold-ai/specfact-govern"),
         CommandAuditCase(
@@ -149,7 +178,7 @@ def build_command_audit_cases() -> list[CommandAuditCase]:
             prefix,
             CommandAuditCase(prefix, (*tuple(prefix.split()), "--help"), phase, "help-only", owner),
         )
-        for command_path in sorted(_collect_typer_paths(app, prefix)):
+        for command_path in sorted(_auditable_paths_for_prefix(app, prefix)):
             cases.setdefault(
                 command_path,
                 CommandAuditCase(