@pennyfarthing/core 11.4.0 → 12.0.0

package/pennyfarthing-dist/pf/git/hooks_installer.py

@@ -1,151 +0,0 @@
-"""
-Git hooks installer — Python replacement for install-git-hooks.sh (145 lines).
-
-Creates .d/ dispatcher directories, symlinks pennyfarthing hooks,
-and migrates existing user hooks.
-
-Usage via CLI:
-    pf git install-hooks
-"""
-
-from __future__ import annotations
-
-from pathlib import Path
-
-from pf.common.config import get_project_root
-
-DISPATCHER_MARKER = "pennyfarthing-dispatcher"
-PF_PREFIX = "10"
-MIGRATED_PREFIX = "50"
-
-# Hook source file → git hook name
-HOOKS = [
-    ("pre-commit.sh", "pre-commit"),
-    ("pre-push.sh", "pre-push"),
-    ("post-merge.sh", "post-merge"),
-]
-
-
-def _generate_dispatcher(template_path: Path, hook_name: str) -> str:
-    """Generate a dispatcher script from the template."""
-    template = template_path.read_text()
-    return template.replace("__HOOK_NAME__", hook_name)
-
-
-def install_git_hooks(project_root: Path | None = None) -> int:
-    """Install git hooks with .d/ dispatcher pattern.
-
-    Creates .d/ directories for each hook, installs dispatcher scripts,
-    and symlinks pennyfarthing hooks into the .d/ directories.
-    Existing non-pennyfarthing hooks are migrated into .d/.
-
-    Args:
-        project_root: Project root. Auto-detected if not provided.
-
-    Returns:
-        0 on success, 1 on error
-    """
-    if project_root is None:
-        project_root = get_project_root()
-
-    pf_dist = project_root / "pennyfarthing-dist"
-    if not pf_dist.is_dir():
-        print("Error: This script requires pennyfarthing-dist/ at the project root")
-        print("       End-user projects should use: pennyfarthing init")
-        return 1
-
-    git_dir = project_root / ".git"
-    if not git_dir.is_dir():
-        print("Error: Not a git repository")
-        return 1
-
-    hooks_source = pf_dist / "scripts" / "hooks"
-    hooks_dest = git_dir / "hooks"
-    hooks_dest.mkdir(exist_ok=True)
-
-    dispatcher_template = hooks_source / "dispatcher-template.sh"
-    if not dispatcher_template.is_file():
-        print(f"Error: dispatcher-template.sh not found at {dispatcher_template}")
-        return 1
-
-    print("Installing git hooks with .d/ dispatcher pattern...")
-    print("  Source: pennyfarthing-dist/scripts/hooks/")
-    print("  Dest:   .git/hooks/")
-    print()
-
-    for source_file, dest_name in HOOKS:
-        source_path = hooks_source / source_file
-        dest_path = hooks_dest / dest_name
-        d_dir = hooks_dest / f"{dest_name}.d"
-        pf_hook_name = f"{PF_PREFIX}-pennyfarthing-{dest_name}.sh"
-        pf_hook_path = d_dir / pf_hook_name
-
-        if not source_path.is_file():
-            print(f"  SKIP {dest_name} (source not found)")
-            continue
-
-        # Create .d/ directory
-        d_dir.mkdir(exist_ok=True)
-
-        # Handle existing hook at dest path
-        if dest_path.exists():
-            if dest_path.is_file():
-                content = dest_path.read_text()
-                if DISPATCHER_MARKER in content:
-                    print(f"  OK   {dest_name} dispatcher (already installed)")
-                elif dest_path.is_symlink():
-                    # Old-style symlink — replace with dispatcher
-                    dest_path.unlink()
-                    dest_path.write_text(_generate_dispatcher(dispatcher_template, dest_name))
-                    dest_path.chmod(0o755)
-                    print(f"  UPD  {dest_name} -> dispatcher")
-                elif "pennyfarthing" in content:
-                    # Old pennyfarthing single-file hook — replace
-                    dest_path.write_text(_generate_dispatcher(dispatcher_template, dest_name))
-                    dest_path.chmod(0o755)
-                    print(f"  UPD  {dest_name} -> dispatcher (was single-file pf hook)")
-                else:
-                    # Non-pennyfarthing hook — migrate into .d/
-                    migrated_name = f"{MIGRATED_PREFIX}-migrated-{dest_name}.sh"
-                    migrated_path = d_dir / migrated_name
-                    if not migrated_path.exists():
-                        dest_path.rename(migrated_path)
-                        migrated_path.chmod(0o755)
-                        print(f"  MIG  {dest_name} -> {dest_name}.d/{migrated_name}")
-                    dest_path.write_text(_generate_dispatcher(dispatcher_template, dest_name))
-                    dest_path.chmod(0o755)
-                    print(f"  NEW  {dest_name} dispatcher")
-            elif dest_path.is_symlink():
-                dest_path.unlink()
-                dest_path.write_text(_generate_dispatcher(dispatcher_template, dest_name))
-                dest_path.chmod(0o755)
-                print(f"  UPD  {dest_name} -> dispatcher")
-        else:
-            # No existing hook — install fresh dispatcher
-            dest_path.write_text(_generate_dispatcher(dispatcher_template, dest_name))
-            dest_path.chmod(0o755)
-            print(f"  NEW  {dest_name} dispatcher")
-
-        # Symlink pennyfarthing hook into .d/
-        # Relative path from .git/hooks/{hook}.d/ to pennyfarthing-dist/scripts/hooks/
-        relative_path = Path("../../../pennyfarthing-dist/scripts/hooks") / source_file
-
-        if pf_hook_path.is_symlink():
-            current_target = pf_hook_path.readlink()
-            if current_target == relative_path:
-                print(f"  OK   {dest_name}.d/{pf_hook_name} (already linked)")
-            else:
-                pf_hook_path.unlink()
-                pf_hook_path.symlink_to(relative_path)
-                print(f"  UPD  {dest_name}.d/{pf_hook_name} -> {relative_path}")
-        elif pf_hook_path.is_file():
-            pf_hook_path.unlink()
-            pf_hook_path.symlink_to(relative_path)
-            print(f"  UPD  {dest_name}.d/{pf_hook_name} -> {relative_path} (was copy)")
-        else:
-            pf_hook_path.symlink_to(relative_path)
-            print(f"  NEW  {dest_name}.d/{pf_hook_name} -> {relative_path}")
-
-    print()
-    print("Done. Verify with: ls -la .git/hooks/*.d/")
-    return 0

package/pennyfarthing-dist/pf/handoff/gate_file.py

@@ -1,105 +0,0 @@
-"""Gate file discovery and resolution.
-
-Resolves gate file references (e.g., "gates/tests-pass") to actual file paths.
-Resolution order:
-  1. .pennyfarthing/gates/{name}.md  (project-local override)
-  2. pennyfarthing-dist/gates/{name}.md  (built-in fallback)
-
-Non-existent files return an error result with status "blocked".
-
-Story: 106-4 (Gate File Discovery and Resolution)
-"""
-
-from __future__ import annotations
-
-from pathlib import Path
-
-
-def resolve_gate_file(
-    gate_ref: str,
-    project_root: Path | None = None,
-) -> dict:
-    """Resolve a gate file reference to an absolute file path.
-
-    Args:
-        gate_ref: Gate reference string (e.g., "gates/tests-pass" or "tests-pass")
-        project_root: Project root path. Auto-detected if None.
-
-    Returns:
-        dict with keys:
-            status: "found" | "not_found"
-            path: str | None  (absolute path if found)
-            error: str | None (error message if not found)
-    """
-    if project_root is None:
-        project_root = _find_project_root()
-
-    name = _sanitize_gate_name(gate_ref)
-    if name is None:
-        return _result(
-            status="not_found",
-            error=f"Invalid gate reference: {gate_ref!r}",
-        )
-
-    # Resolution order: local first, built-in fallback
-    search_paths = [
-        project_root / ".pennyfarthing" / "gates" / f"{name}.md",
-        project_root / "pennyfarthing-dist" / "gates" / f"{name}.md",
-    ]
-
-    for candidate in search_paths:
-        if candidate.is_file():
-            return _result(status="found", path=str(candidate.resolve()))
-
-    return _result(
-        status="not_found",
-        error=f"Gate file not found: {name}",
-    )
-
-
-def _sanitize_gate_name(gate_ref: str) -> str | None:
-    """Extract a clean gate name from a reference string.
-
-    Strips 'gates/' prefix and '.md' suffix. Rejects empty names
-    and path traversal attempts.
-    """
-    if not gate_ref:
-        return None
-
-    name = gate_ref
-    # Strip gates/ prefix
-    if name.startswith("gates/"):
-        name = name[len("gates/"):]
-    # Strip .md suffix
-    if name.endswith(".md"):
-        name = name[: -len(".md")]
-
-    if not name:
-        return None
-
-    # Reject path traversal
-    if ".." in name or "/" in name:
-        return None
-
-    return name
-
-
-def _result(
-    status: str,
-    path: str | None = None,
-    error: str | None = None,
-) -> dict:
-    return {
-        "status": status,
-        "path": path,
-        "error": error,
-    }
-
-
-def _find_project_root() -> Path:
-    """Walk up from cwd looking for .pennyfarthing/ directory."""
-    cwd = Path.cwd()
-    for parent in [cwd, *cwd.parents]:
-        if (parent / ".pennyfarthing").is_dir():
-            return parent
-    return cwd