@blxzer/pactile 0.5.0 → 0.6.0-beta.2

package/dist/templates/pactile/scripts/common/cli_adapter.py

@@ -1,135 +0,0 @@
-"""
-CLI Adapter for Cursor.
-
-Cursor-only fork: abstracts Pactile paths and command layout for Cursor IDE.
-
-Usage:
-    from common.cli_adapter import CLIAdapter
-
-    adapter = CLIAdapter("cursor")
-"""
-
-from __future__ import annotations
-
-from dataclasses import dataclass
-from pathlib import Path
-from typing import ClassVar, Literal
-
-Platform = Literal["cursor"]
-
-
-@dataclass
-class CLIAdapter:
-    """Adapter for Cursor IDE integration."""
-
-    platform: Platform
-
-    _AGENT_NAME_MAP: ClassVar[dict[Platform, dict[str, str]]] = {
-        "cursor": {},
-    }
-
-    def get_agent_name(self, agent: str) -> str:
-        mapping = self._AGENT_NAME_MAP.get(self.platform, {})
-        return mapping.get(agent, agent)
-
-    @property
-    def config_dir_name(self) -> str:
-        return ".cursor"
-
-    def get_config_dir(self, project_root: Path) -> Path:
-        return project_root / self.config_dir_name
-
-    def get_agent_path(self, agent: str, project_root: Path) -> Path:
-        mapped_name = self.get_agent_name(agent)
-        return self.get_config_dir(project_root) / "agents" / f"{mapped_name}.md"
-
-    def get_commands_path(self, project_root: Path, *parts: str) -> Path:
-        if not parts:
-            return self.get_config_dir(project_root) / "commands"
-        if len(parts) >= 2 and parts[0] == "pactile":
-            filename = parts[-1]
-            return (
-                self.get_config_dir(project_root) / "commands" / f"pactile-{filename}"
-            )
-        return self.get_config_dir(project_root) / "commands" / Path(*parts)
-
-    def get_pactile_command_path(self, name: str) -> str:
-        return f".cursor/commands/pactile-{name}.md"
-
-    def get_non_interactive_env(self) -> dict[str, str]:
-        return {}
-
-    def build_run_command(
-        self,
-        agent: str,
-        prompt: str,
-        session_id: str | None = None,
-        skip_permissions: bool = True,
-        verbose: bool = True,
-        json_output: bool = True,
-    ) -> list[str]:
-        _ = (agent, prompt, session_id, skip_permissions, verbose, json_output)
-        raise ValueError(
-            "Cursor is IDE-only; CLI agent run is not supported. Use Cursor Agent in the IDE."
-        )
-
-    def build_resume_command(self, session_id: str) -> list[str]:
-        _ = session_id
-        raise ValueError("Cursor is IDE-only; CLI resume is not supported.")
-
-    def get_resume_command_str(self, session_id: str, cwd: str | None = None) -> str:
-        cmd = self.build_resume_command(session_id)
-        cmd_str = " ".join(cmd)
-        if cwd:
-            return f"cd {cwd} && {cmd_str}"
-        return cmd_str
-
-    @property
-    def is_cursor(self) -> bool:
-        return True
-
-    @property
-    def cli_name(self) -> str:
-        return "cursor"
-
-    @property
-    def supports_cli_agents(self) -> bool:
-        return False
-
-    @property
-    def requires_agent_definition_file(self) -> bool:
-        return True
-
-    @property
-    def supports_session_id_on_create(self) -> bool:
-        return False
-
-    def extract_session_id_from_log(self, log_content: str) -> str | None:
-        _ = log_content
-        return None
-
-
-def get_cli_adapter(platform: str = "cursor") -> CLIAdapter:
-    if platform != "cursor":
-        raise ValueError(f"Unsupported platform: {platform} (must be 'cursor')")
-    return CLIAdapter(platform="cursor")
-
-
-_ALL_PLATFORM_CONFIG_DIRS = (".cursor",)
-
-
-def _has_other_platform_dir(project_root: Path, exclude: set[str]) -> bool:
-    return any(
-        (project_root / d).is_dir()
-        for d in _ALL_PLATFORM_CONFIG_DIRS
-        if d not in exclude
-    )
-
-
-def detect_platform(project_root: Path) -> Platform:
-    override = __import__("os").environ.get("PACTILE_PLATFORM", "").strip().lower()
-    if override == "cursor":
-        return "cursor"
-    if (project_root / ".cursor").is_dir():
-        return "cursor"
-    return "cursor"

package/dist/templates/pactile/scripts/common/cli_environment.py

@@ -1,155 +0,0 @@
-#!/usr/bin/env python3
-"""Classify common Pactile CLI environment blockers and suggest repairs."""
-
-from __future__ import annotations
-
-from dataclasses import dataclass
-
-
-@dataclass(frozen=True)
-class EnvironmentBlocker:
-    """A classified environment issue with a user-facing repair hint."""
-
-    kind: str
-    summary: str
-    repair: str
-
-
-def classify_git_failure(detail: str) -> EnvironmentBlocker | None:
-    """Map git stderr/stdout into a blocker kind and repair hint."""
-    text = (detail or "").strip()
-    if not text:
-        return None
-    lowered = text.lower()
-
-    if "dubious ownership" in lowered or "safe.directory" in lowered:
-        return EnvironmentBlocker(
-            kind="git-safe-directory",
-            summary="Git refused the repository (safe.directory / dubious ownership).",
-            repair=(
-                "Add the repo to Git safe.directory, e.g. "
-                "`git config --global --add safe.directory <absolute-repo-path>`, "
-                "or run one-off commands with "
-                "`git -c safe.directory=<absolute-repo-path> ...`."
-            ),
-        )
-
-    if "not a git repository" in lowered or "not a git repo" in lowered:
-        return EnvironmentBlocker(
-            kind="non-git-root",
-            summary="This directory is not inside a Git work tree.",
-            repair=(
-                "Run Git commands from a cloned repository root, or initialize Git here "
-                "only when the workflow explicitly requires it."
-            ),
-        )
-
-    if (
-        "not a git worktree" in lowered
-        or ("rev-parse" in lowered and "true" not in lowered)
-    ):
-        if "fatal:" in lowered or "not a git" in lowered:
-            return EnvironmentBlocker(
-                kind="non-git-root",
-                summary="Git repository required for this command.",
-                repair=(
-                    "Use a Pactile project inside a Git clone. "
-                    "Worktree and merge commands need `git rev-parse --is-inside-work-tree` to succeed."
-                ),
-            )
-
-    return None
-
-
-def classify_subprocess_failure(detail: str) -> EnvironmentBlocker | None:
-    """Classify non-git subprocess failures (npm cache, permissions)."""
-    text = (detail or "").strip()
-    if not text:
-        return None
-    lowered = text.lower()
-
-    if "eperm" in lowered or "eacces" in lowered:
-        if "npm" in lowered or "cache" in lowered or "appdata" in lowered:
-            return EnvironmentBlocker(
-                kind="npm-cache-eperm",
-                summary="npm cache or install path is not writable (EPERM/EACCES).",
-                repair=(
-                    "Close processes locking the npm cache, run the terminal as a user with "
-                    "write access, or clear/repair the npm cache directory. "
-                    "Do not run destructive cache wipes without explicit approval."
-                ),
-            )
-        return EnvironmentBlocker(
-            kind="permission-denied",
-            summary="Command failed with EPERM/EACCES (permission or sandbox restriction).",
-            repair=(
-                "Retry from a shell with sufficient permissions, or adjust sandbox/policy "
-                "so child_process can spawn the required tool."
-            ),
-        )
-
-    return None
-
-
-def format_git_repo_errors(raw_errors: list[str]) -> list[str]:
-    """Rewrite generic git repo errors with classified summaries."""
-    out: list[str] = []
-    for item in raw_errors:
-        if not item.startswith("Git repository required:"):
-            out.append(item)
-            continue
-        detail = item.split(":", 1)[-1].strip()
-        blocker = classify_git_failure(detail)
-        if blocker:
-            out.append(f"[{blocker.kind}] {blocker.summary} ({detail})")
-        else:
-            out.append(item)
-    return out
-
-
-def print_environment_repair_hints(
-    raw_errors: list[str],
-    *,
-    stream=None,
-) -> None:
-    """Print deduplicated repair hints for classified errors."""
-    import sys
-
-    if stream is None:
-        stream = sys.stderr
-
-    from .log import Colors, colored
-
-    seen: set[str] = set()
-    hints: list[str] = []
-
-    for item in raw_errors:
-        detail = item
-        if ":" in item and item.startswith("["):
-            detail = item.split(")", 1)[-1].strip().strip("()")
-        for classifier in (classify_git_failure, classify_subprocess_failure):
-            blocker = classifier(detail)
-            if blocker and blocker.repair not in seen:
-                seen.add(blocker.repair)
-                hints.append(f"[{blocker.kind}] {blocker.repair}")
-
-    if not hints:
-        return
-
-    print(colored("Environment repair:", Colors.BLUE), file=stream)
-    for hint in hints:
-        print(f"  - {hint}", file=stream)
-
-
-def optional_capability_note(capabilities: list[str] | None) -> str | None:
-    """Return a short note when optional capabilities are declared but unavailable."""
-    if not capabilities:
-        return None
-    names = [c for c in capabilities if isinstance(c, str) and c.strip()]
-    if not names:
-        return None
-    joined = ", ".join(names)
-    return (
-        f"Optional capabilities declared in implement.md ({joined}) may require platform "
-        "support or extra setup; absence is not fatal unless the task contract requires them."
-    )