path-sync 0.1.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

path_sync/cmd_boot.py

@@ -6,7 +6,7 @@ from typing import Annotated
 
 import typer
 
-from path_sync import git_ops, workflow_gen
+from path_sync import git_ops
 from path_sync.file_utils import ensure_parents_write_text
 from path_sync.models import (
     Destination,
@@ -27,44 +27,35 @@ def boot(
     dest_paths: Annotated[
         list[str], typer.Option("-d", "--dest", help="Destination relative paths")
     ] = [],
-    always_paths: Annotated[
-        list[str], typer.Option("-p", "--path", help="Always paths (glob patterns)")
+    sync_paths: Annotated[
+        list[str], typer.Option("-p", "--path", help="Paths to sync (glob patterns)")
     ] = [],
     dry_run: bool = typer.Option(False, "--dry-run", help="Preview without writing"),
-    regen: bool = typer.Option(False, "--regen", help="Regenerate all files"),
+    regen: bool = typer.Option(False, "--regen", help="Regenerate config"),
 ) -> None:
-    """Initialize or update SRC repo tooling."""
+    """Initialize or update SRC repo config."""
     repo_root = find_repo_root(Path.cwd())
-    config_path = resolve_config_path(repo_root, name, SrcConfig)
+    config_path = resolve_config_path(repo_root, name)
 
     if config_path.exists() and not regen:
-        config = load_yaml_model(config_path, SrcConfig)
+        load_yaml_model(config_path, SrcConfig)
         logger.info(f"Using existing config: {config_path}")
     else:
         src_repo = git_ops.get_repo(repo_root)
         src_repo_url = git_ops.get_remote_url(src_repo, "origin")
 
         destinations = _build_destinations(repo_root, dest_paths)
-        path_mappings = [PathMapping(src_path=p) for p in always_paths]
+        path_mappings = [PathMapping(src_path=p) for p in sync_paths]
 
         config = SrcConfig(
             name=name,
             src_repo_url=src_repo_url,
-            always_paths=path_mappings,
+            paths=path_mappings,
             destinations=destinations,
         )
         config_content = dump_yaml_model(config)
         _write_file(config_path, config_content, dry_run, "config")
 
-    if config.src_tools_update.github_workflows:
-        workflow_path = repo_root / workflow_gen.copy_workflow_path(name)
-        if not workflow_path.exists() or regen:
-            content = workflow_gen.generate_copy_workflow(config)
-            _write_file(workflow_path, content, dry_run, "workflow")
-
-    if config.src_tools_update.justfile:
-        _update_justfile(repo_root, name, dry_run)
-
     if dry_run:
         logger.info("Dry run complete - no files written")
     else:
@@ -96,10 +87,3 @@ def _write_file(path: Path, content: str, dry_run: bool, desc: str) -> None:
         return
     ensure_parents_write_text(path, content)
     logger.info(f"Wrote {desc}: {path}")
-
-
-def _update_justfile(repo_root: Path, name: str, dry_run: bool) -> None:
-    justfile_path = repo_root / "justfile"
-    workflow_gen.update_justfile(
-        justfile_path, name, workflow_gen.JustfileRecipeKind.COPY, dry_run
-    )

path_sync/cmd_copy.py

@@ -2,7 +2,6 @@ from __future__ import annotations
 
 import glob
 import logging
-import subprocess
 import tempfile
 from contextlib import contextmanager
 from dataclasses import dataclass, field
@@ -10,7 +9,7 @@ from pathlib import Path
 
 import typer
 
-from path_sync import git_ops, header, sections, workflow_gen
+from path_sync import git_ops, header, sections
 from path_sync.file_utils import ensure_parents_write_text
 from path_sync.models import (
     LOG_FORMAT,
@@ -30,16 +29,25 @@ EXIT_CHANGES = 1
 EXIT_ERROR = 2
 
 
+def _prompt(message: str, no_prompt: bool) -> bool:
+    if no_prompt:
+        return True
+    try:
+        response = input(f"{message} [y/n]: ").strip().lower()
+        return response == "y"
+    except (EOFError, KeyboardInterrupt):
+        return False
+
+
 @dataclass
 class SyncResult:
     content_changes: int = 0
-    tools_changes: int = 0
     orphans_deleted: int = 0
     synced_paths: set[Path] = field(default_factory=set)
 
     @property
     def total(self) -> int:
-        return self.content_changes + self.tools_changes + self.orphans_deleted
+        return self.content_changes + self.orphans_deleted
 
 
 @contextmanager
@@ -62,13 +70,12 @@ def capture_sync_log(dest_name: str):
 class CopyOptions:
     dry_run: bool = False
     force_overwrite: bool = False
-    skip_checkout: bool = False
+    no_checkout: bool = False
     checkout_from_default: bool = False
-    force_push: bool = True
-    force_tools_pr: bool = False
-    no_commit: bool = False
-    no_push: bool = False
+    local: bool = False
+    no_prompt: bool = False
     no_pr: bool = False
+    skip_orphan_cleanup: bool = False
     pr_title: str = ""
     pr_labels: str = ""
     pr_reviewers: str = ""
@@ -84,27 +91,65 @@ def copy(
     dry_run: bool = typer.Option(False, "--dry-run", help="Preview without writing"),
     force_overwrite: bool = typer.Option(
         False,
-        "--force-no-header-updates",
-        help="Overwrite files even if header removed",
+        "--force-overwrite",
+        help="Overwrite files even if header removed (opted out)",
+    ),
+    detailed_exit_code: bool = typer.Option(
+        False,
+        "--detailed-exit-code",
+        help="Exit 0=no changes, 1=changes, 2=error",
+    ),
+    no_checkout: bool = typer.Option(
+        False,
+        "--no-checkout",
+        help="Skip branch switching before sync",
     ),
-    detailed_exit_code: bool = typer.Option(False, "--detailed-exit-code"),
-    skip_dest_checkout: bool = typer.Option(False, "--skip-dest-checkout"),
     checkout_from_default: bool = typer.Option(
         False,
         "--checkout-from-default",
         help="Reset to origin/default before sync (for CI)",
     ),
-    force_push: bool = typer.Option(True, "--force-push/--no-force-push"),
-    force_tools_pr: bool = typer.Option(
-        False, "--force-tools-pr", help="Create PR even if only tools changed"
+    local: bool = typer.Option(
+        False,
+        "--local",
+        help="No git operations after sync (no commit/push/PR)",
+    ),
+    no_prompt: bool = typer.Option(
+        False,
+        "-y",
+        "--no-prompt",
+        help="Skip confirmations (for CI)",
+    ),
+    no_pr: bool = typer.Option(
+        False,
+        "--no-pr",
+        help="Push but skip PR creation",
+    ),
+    pr_title: str = typer.Option(
+        "",
+        "--pr-title",
+        help="Override PR title (supports {name}, {dest_name})",
+    ),
+    pr_labels: str = typer.Option(
+        "",
+        "--pr-labels",
+        help="Comma-separated PR labels",
+    ),
+    pr_reviewers: str = typer.Option(
+        "",
+        "--pr-reviewers",
+        help="Comma-separated PR reviewers",
+    ),
+    pr_assignees: str = typer.Option(
+        "",
+        "--pr-assignees",
+        help="Comma-separated PR assignees",
+    ),
+    skip_orphan_cleanup: bool = typer.Option(
+        False,
+        "--skip-orphan-cleanup",
+        help="Skip deletion of orphaned synced files",
     ),
-    no_commit: bool = typer.Option(False, "--no-commit"),
-    no_push: bool = typer.Option(False, "--no-push"),
-    no_pr: bool = typer.Option(False, "--no-pr"),
-    pr_title: str = typer.Option("", "--pr-title"),
-    pr_labels: str = typer.Option("", "--pr-labels"),
-    pr_reviewers: str = typer.Option("", "--pr-reviewers"),
-    pr_assignees: str = typer.Option("", "--pr-assignees"),
 ) -> None:
     """Copy files from SRC to DEST repositories."""
     src_root = find_repo_root(Path.cwd())
@@ -122,13 +167,12 @@ def copy(
     opts = CopyOptions(
         dry_run=dry_run,
         force_overwrite=force_overwrite,
-        skip_checkout=skip_dest_checkout,
+        no_checkout=no_checkout,
         checkout_from_default=checkout_from_default,
-        force_push=force_push,
-        force_tools_pr=force_tools_pr,
-        no_commit=no_commit,
-        no_push=no_push,
+        local=local,
+        no_prompt=no_prompt,
         no_pr=no_pr,
+        skip_orphan_cleanup=skip_orphan_cleanup,
         pr_title=pr_title or config.pr_defaults.title,
         pr_labels=pr_labels or ",".join(config.pr_defaults.labels),
         pr_reviewers=pr_reviewers or ",".join(config.pr_defaults.reviewers),
@@ -168,9 +212,21 @@ def _sync_destination(
     log_path: Path,
 ) -> int:
     dest_root = (src_root / dest.dest_path_relative).resolve()
-    dest_repo = _ensure_dest_repo(dest, dest_root)
 
-    if not opts.skip_checkout and not opts.dry_run:
+    if opts.dry_run and not dest_root.exists():
+        raise ValueError(
+            f"Destination repo not found: {dest_root}. "
+            "Clone it first or run without --dry-run."
+        )
+
+    dest_repo = _ensure_dest_repo(dest, dest_root, opts.dry_run)
+
+    should_checkout = (
+        not opts.no_checkout
+        and not opts.dry_run
+        and _prompt(f"Switch to {dest.copy_branch}?", opts.no_prompt)
+    )
+    if should_checkout:
         git_ops.prepare_copy_branch(
             repo=dest_repo,
             default_branch=dest.default_branch,
@@ -179,30 +235,38 @@ def _sync_destination(
         )
 
     result = _sync_paths(config, dest, src_root, dest_root, opts)
+    _print_sync_summary(dest, result)
 
     if result.total == 0:
         logger.info(f"{dest.name}: No changes")
         return 0
-    logger.info(f"{dest.name}: Found {result.total} changes")
-    if (
-        result.content_changes == 0
-        and result.orphans_deleted == 0
-        and not opts.force_tools_pr
-    ):
-        logger.info(f"{dest.name}: Tools-only changes, skipping PR")
-        return 0
 
     if opts.dry_run:
-        logger.info(f"{dest.name}: Would make {result.total} changes")
         return result.total
 
-    return _commit_and_pr(
+    _commit_and_pr(
         config, dest_repo, dest_root, dest, current_sha, src_repo_url, opts, log_path
     )
+    return result.total
+
+
+def _print_sync_summary(dest: Destination, result: SyncResult) -> None:
+    typer.echo(f"\nSyncing to {dest.name}...", err=True)
+    if result.content_changes > 0:
+        typer.echo(f"  [{result.content_changes} files synced]", err=True)
+    if result.orphans_deleted > 0:
+        typer.echo(f"  [-] {result.orphans_deleted} orphans deleted", err=True)
+    if result.total > 0:
+        typer.echo(f"\n{result.total} changes ready.", err=True)
 
 
-def _ensure_dest_repo(dest: Destination, dest_root: Path):
+def _ensure_dest_repo(dest: Destination, dest_root: Path, dry_run: bool):
     if not dest_root.exists():
+        if dry_run:
+            raise ValueError(
+                f"Destination repo not found: {dest_root}. "
+                "Clone it first or run without --dry-run."
+            )
         if not dest.repo_url:
             raise ValueError(f"Dest {dest.name} not found and no repo_url configured")
         git_ops.clone_repo(dest.repo_url, dest_root)
@@ -230,10 +294,10 @@ def _sync_paths(
         result.content_changes += changes
         result.synced_paths.update(paths)
 
-    result.tools_changes = _sync_tools_update(config, dest, dest_root, opts)
-    result.orphans_deleted = _cleanup_orphans(
-        dest_root, config.name, result.synced_paths, opts.dry_run
-    )
+    if not opts.skip_orphan_cleanup:
+        result.orphans_deleted = _cleanup_orphans(
+            dest_root, config.name, result.synced_paths, opts.dry_run
+        )
     return result
 
 
@@ -325,13 +389,13 @@ def _copy_with_header(
             src_content, dest_path, skip_list, config_name, dry_run, force_overwrite
         )
 
-    # No sections: full-file replacement
     if dest_path.exists():
         existing = dest_path.read_text()
-        if not header.has_header(existing) and not force_overwrite:
+        has_header = header.has_header(existing)
+        if not has_header and not force_overwrite:
             logger.info(f"Skipping {dest_path} (header removed - opted out)")
             return 0
-        if header.remove_header(existing) == src_content:
+        if header.remove_header(existing) == src_content and has_header:
             return 0
 
     new_content = header.add_header(src_content, dest_path.suffix, config_name)
@@ -366,9 +430,8 @@ def _copy_with_sections(
 
     new_content = header.add_header(new_body, dest_path.suffix, config_name)
 
-    if dest_path.exists():
-        if dest_path.read_text() == new_content:
-            return 0
+    if dest_path.exists() and dest_path.read_text() == new_content:
+        return 0
 
     if dry_run:
         logger.info(f"[DRY RUN] Would write: {dest_path}")
@@ -408,100 +471,6 @@ def _find_files_with_config(dest_root: Path, config_name: str) -> list[Path]:
     return result
 
 
-def _sync_tools_update(
-    config: SrcConfig,
-    dest: Destination,
-    dest_root: Path,
-    opts: CopyOptions,
-) -> int:
-    changes = 0
-
-    if dest.tools_update.github_workflows:
-        wf_path = dest_root / workflow_gen.validate_workflow_path(config.name)
-        if not wf_path.exists():
-            content = workflow_gen.generate_validate_workflow(
-                name=config.name,
-                copy_branch=dest.copy_branch,
-                default_branch=dest.default_branch,
-            )
-            if opts.dry_run:
-                logger.info(f"[DRY RUN] Would write workflow: {wf_path}")
-            else:
-                ensure_parents_write_text(wf_path, content)
-                logger.info(f"Wrote workflow: {wf_path}")
-            changes += 1
-
-    if dest.tools_update.justfile:
-        changes += _sync_justfile_recipe(config.name, dest_root, opts)
-
-    if dest.tools_update.path_sync_wheel:
-        _sync_wheel(dest_root, opts)
-
-    return changes
-
-
-def _sync_justfile_recipe(name: str, dest_root: Path, opts: CopyOptions) -> int:
-    justfile_path = dest_root / "justfile"
-    changed = workflow_gen.update_justfile(
-        justfile_path, name, workflow_gen.JustfileRecipeKind.VALIDATE, opts.dry_run
-    )
-    return 1 if changed else 0
-
-
-def _sync_wheel(dest_root: Path, opts: CopyOptions) -> None:
-    pkg_root = Path(__file__).parent.parent
-    wheel = _build_wheel(pkg_root, opts.dry_run)
-    if not wheel:
-        return
-
-    dest_dir = dest_root / ".github"
-    dest_wheel = dest_dir / wheel.name
-
-    for old_wheel in dest_dir.glob("path_sync-*.whl"):
-        if old_wheel != dest_wheel:
-            if opts.dry_run:
-                logger.info(f"[DRY RUN] Would remove old wheel: {old_wheel}")
-            else:
-                old_wheel.unlink()
-                logger.info(f"Removed old wheel: {old_wheel}")
-
-    if opts.dry_run:
-        logger.info(f"[DRY RUN] Would copy wheel: {dest_wheel}")
-        return
-
-    dest_dir.mkdir(parents=True, exist_ok=True)
-    dest_wheel.write_bytes(wheel.read_bytes())
-    logger.info(f"Copied wheel: {dest_wheel}")
-
-
-def _build_wheel(pkg_root: Path, dry_run: bool) -> Path | None:
-    dist_dir = pkg_root / "dist"
-
-    if dry_run:
-        logger.info("[DRY RUN] Would build wheel")
-        wheels = sorted(dist_dir.glob("path_sync-*.whl")) if dist_dir.exists() else []
-        return wheels[-1] if wheels else None
-
-    if dist_dir.exists():
-        for old in dist_dir.glob("path_sync-*.whl"):
-            old.unlink()
-
-    logger.info("Building wheel...")
-    result = subprocess.run(
-        ["uv", "build", "--wheel"],
-        cwd=pkg_root,
-        capture_output=True,
-        text=True,
-    )
-    if result.returncode != 0:
-        logger.error(f"Failed to build wheel: {result.stderr}")
-        raise RuntimeError("Wheel build failed")
-
-    wheels = sorted(dist_dir.glob("path_sync-*.whl"))
-    assert len(wheels) == 1, f"Expected 1 wheel, got {len(wheels)}"
-    return wheels[0]
-
-
 def _commit_and_pr(
     config: SrcConfig,
     repo,
@@ -511,19 +480,26 @@ def _commit_and_pr(
     src_repo_url: str,
     opts: CopyOptions,
     log_path: Path,
-) -> int:
-    if opts.no_commit:
-        return 1
+) -> None:
+    if opts.local:
+        logger.info("Local mode: skipping commit/push/PR")
+        return
 
-    git_ops.commit_changes(repo, f"chore: sync {config.name} from {sha[:8]}")
+    if not _prompt("Commit changes?", opts.no_prompt):
+        return
 
-    if opts.no_push:
-        return 1
+    commit_msg = f"chore: sync {config.name} from {sha[:8]}"
+    git_ops.commit_changes(repo, commit_msg)
+    typer.echo(f"  Committed: {commit_msg}", err=True)
 
-    git_ops.push_branch(repo, dest.copy_branch, force=opts.force_push)
+    if not _prompt("Push to origin?", opts.no_prompt):
+        return
 
-    if opts.no_pr:
-        return 1
+    git_ops.push_branch(repo, dest.copy_branch, force=True)
+    typer.echo(f"  Pushed: {dest.copy_branch} (force)", err=True)
+
+    if opts.no_pr or not _prompt("Create PR?", opts.no_prompt):
+        return
 
     sync_log = log_path.read_text() if log_path.exists() else ""
     pr_body = config.pr_defaults.format_body(
@@ -534,7 +510,7 @@ def _commit_and_pr(
     )
 
     title = opts.pr_title.format(name=config.name, dest_name=dest.name)
-    git_ops.create_or_update_pr(
+    pr_url = git_ops.create_or_update_pr(
         dest_root,
         dest.copy_branch,
         title,
@@ -543,4 +519,5 @@ def _commit_and_pr(
         opts.pr_reviewers.split(",") if opts.pr_reviewers else None,
         opts.pr_assignees.split(",") if opts.pr_assignees else None,
     )
-    return 1
+    if pr_url:
+        typer.echo(f"  Created PR: {pr_url}", err=True)

path_sync/cmd_copy_test.py

@@ -1,4 +1,11 @@
-from path_sync.cmd_copy import _cleanup_orphans, _sync_path
+import pytest
+
+from path_sync.cmd_copy import (
+    CopyOptions,
+    _cleanup_orphans,
+    _ensure_dest_repo,
+    _sync_path,
+)
 from path_sync.header import add_header, has_header
 from path_sync.models import Destination, PathMapping
 
@@ -48,6 +55,27 @@ def test_sync_skips_opted_out_file(tmp_path):
     assert (dest_root / "file.py").read_text() == "local content without header"
 
 
+def test_force_overwrite_adds_header_when_content_matches(tmp_path):
+    src_root = tmp_path / "src"
+    dest_root = tmp_path / "dest"
+    src_root.mkdir()
+    dest_root.mkdir()
+
+    content = "same content"
+    (src_root / "file.py").write_text(content)
+    (dest_root / "file.py").write_text(content)  # No header, same content
+
+    mapping = PathMapping(src_path="file.py")
+    changes, _ = _sync_path(
+        mapping, src_root, dest_root, _make_dest(), CONFIG_NAME, False, True
+    )
+
+    assert changes == 1
+    result = (dest_root / "file.py").read_text()
+    assert has_header(result)
+    assert content in result
+
+
 def test_cleanup_orphans(tmp_path):
     dest_root = tmp_path / "dest"
     dest_root.mkdir()
@@ -133,3 +161,20 @@ keep this
 
     assert changes == 0
     assert "keep this" in (dest_root / "file.sh").read_text()
+
+
+def test_ensure_dest_repo_dry_run_errors_if_missing(tmp_path):
+    dest = _make_dest()
+    dest_root = tmp_path / "missing_repo"
+    with pytest.raises(ValueError, match="Destination repo not found"):
+        _ensure_dest_repo(dest, dest_root, dry_run=True)
+
+
+def test_copy_options_defaults():
+    opts = CopyOptions()
+    assert not opts.dry_run
+    assert not opts.force_overwrite
+    assert not opts.no_checkout
+    assert not opts.local
+    assert not opts.no_prompt
+    assert not opts.no_pr

path_sync/cmd_validate.py

@@ -32,6 +32,9 @@ def validate_no_changes(
     if current_branch.startswith("sync/"):
         logger.info(f"On sync branch {current_branch}, validation skipped")
         return
+    if current_branch == branch:
+        logger.info(f"On default branch {branch}, validation skipped")
+        return
 
     skip_sections = (
         parse_skip_sections(skip_sections_opt) if skip_sections_opt else None

path_sync/models.py

@@ -58,17 +58,6 @@ class HeaderConfig(BaseModel):
     )
 
 
-class ToolsUpdate(BaseModel):
-    justfile: bool = True
-    path_sync_wheel: bool = True
-    github_workflows: bool = True
-
-
-class SrcToolsUpdate(BaseModel):
-    justfile: bool = True
-    github_workflows: bool = True
-
-
 DEFAULT_BODY_TEMPLATE = """\
 Synced from [{src_repo_name}]({src_repo_url}) @ `{src_sha_short}`
 
@@ -119,7 +108,6 @@ class Destination(BaseModel):
     copy_branch: str = "sync/path-sync"
     default_branch: str = "main"
     skip_sections: dict[str, list[str]] = Field(default_factory=dict)
-    tools_update: ToolsUpdate = Field(default_factory=ToolsUpdate)
 
 
 class SrcConfig(BaseModel):
@@ -130,7 +118,6 @@ class SrcConfig(BaseModel):
     src_repo_url: str = ""
     schedule: str = "0 6 * * *"
     header_config: HeaderConfig = Field(default_factory=HeaderConfig)
-    src_tools_update: SrcToolsUpdate = Field(default_factory=SrcToolsUpdate)
     pr_defaults: PRDefaults = Field(default_factory=PRDefaults)
     paths: list[PathMapping] = Field(default_factory=list)
     destinations: list[Destination] = Field(default_factory=list)

path_sync-0.2.1.dist-info/METADATA

@@ -0,0 +1,271 @@
+Metadata-Version: 2.4
+Name: path-sync
+Version: 0.2.1
+Author-email: EspenAlbert <espen.albert1@gmail.com>
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.13
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: typer>=0.16.0
+Description-Content-Type: text/markdown
+
+# path-sync
+
+Sync files from a source repo to multiple destination repos.
+
+## Overview
+
+**Problem**: You have shared config files (linter rules, CI templates, editor settings) that should be consistent across multiple repositories. Manual copying leads to drift.
+
+**Solution**: path-sync provides one-way file syncing with clear ownership:
+
+| Term | Definition |
+|------|------------|
+| **SRC** | Source repository containing the canonical files |
+| **DEST** | Destination repository receiving synced files |
+| **Header** | Comment added to synced files marking them as managed |
+| **Section** | Marked region within a file for partial syncing |
+
+**Key behaviors**:
+- SRC owns synced content; DEST should not edit it
+- Files with headers are updated on each sync
+- Remove a header to opt-out (file becomes DEST-owned)
+- Orphaned files (removed from SRC) are deleted in DEST
+
+## Installation
+
+```bash
+# From PyPI
+uvx path-sync --help
+
+# Or install in project
+uv pip install path-sync
+```
+
+## Quick Start
+
+### 1. Bootstrap a source config
+
+```bash
+path-sync boot -n myconfig -d ../dest-repo1 -d ../dest-repo2 -p '.cursor/**/*.mdc'
+```
+
+Creates `.github/myconfig.src.yaml` with auto-detected git remote and destinations.
+
+### 2. Copy files to destinations
+
+```bash
+path-sync copy -n myconfig
+```
+
+By default, prompts before each git operation. See [Usage Scenarios](#usage-scenarios) for common patterns.
+
+| Flag | Description |
+|------|-------------|
+| `-d dest1,dest2` | Filter specific destinations |
+| `--dry-run` | Preview without writing (requires existing repos) |
+| `-y, --no-prompt` | Skip confirmations (for CI) |
+| `--local` | No git ops after sync (no commit/push/PR) |
+| `--no-checkout` | Skip branch switching before sync |
+| `--checkout-from-default` | Reset to origin/default before sync |
+| `--no-pr` | Push but skip PR creation |
+| `--force-overwrite` | Overwrite files even if header removed (opted out) |
+| `--detailed-exit-code` | Exit 0=no changes, 1=changes, 2=error |
+| `--skip-orphan-cleanup` | Skip deletion of orphaned synced files |
+| `--pr-title` | Override PR title (supports `{name}`, `{dest_name}`) |
+| `--pr-labels` | Comma-separated PR labels |
+| `--pr-reviewers` | Comma-separated PR reviewers |
+| `--pr-assignees` | Comma-separated PR assignees |
+
+### 3. Validate (run in dest repo)
+
+```bash
+uvx path-sync validate-no-changes -b main
+```
+
+Options:
+- `-b, --branch` - Default branch to compare against (default: main)
+- `--skip-sections` - Comma-separated `path:section_id` pairs to skip (e.g., `justfile:coverage`)
+
+## Usage Scenarios
+
+| Scenario | Command |
+|----------|---------|
+| Interactive sync | `copy -n cfg` |
+| CI fresh sync | `copy -n cfg --checkout-from-default -y` |
+| Local preview | `copy -n cfg --dry-run` |
+| Local test files | `copy -n cfg --local` |
+| Already on branch | `copy -n cfg --no-checkout --local` |
+| Push, manual PR | `copy -n cfg --no-pr -y` |
+| Force opted-out | `copy -n cfg --force-overwrite` |
+
+## Section Markers
+
+For partial file syncing (e.g., `justfile`, `pyproject.toml`), wrap sections with markers:
+
+```makefile
+# === DO_NOT_EDIT: path-sync default ===
+lint:
+    ruff check .
+# === OK_EDIT ===
+```
+
+- **`DO_NOT_EDIT: path-sync {id}`** - Start of managed section with identifier
+- **`OK_EDIT`** - End marker (content below is editable)
+
+During sync, only content within markers is replaced. Destination can have extra sections.
+
+Use `skip_sections` in destination config to exclude specific sections from sync:
+
+```yaml
+destinations:
+  - name: dest1
+    dest_path_relative: ../dest1
+    skip_sections:
+      justfile: [coverage]  # keep local coverage recipe
+```
+## Config Reference
+
+**Source config** (`.github/{name}.src.yaml`):
+
+```yaml
+name: cursor
+src_repo_url: https://github.com/user/src-repo
+schedule: "0 6 * * *"
+paths:
+  - src_path: .cursor/**/*.mdc
+  - src_path: templates/justfile
+    dest_path: justfile
+destinations:
+  - name: dest1
+    repo_url: https://github.com/user/dest1
+    dest_path_relative: ../dest1
+    copy_branch: sync/path-sync
+    default_branch: main
+    skip_sections:
+      justfile: [coverage]
+```
+
+| Field | Description |
+|-------|-------------|
+| `name` | Config identifier |
+| `src_repo_url` | Source repo URL (auto-detected from git remote) |
+| `schedule` | Cron for scheduled sync workflow |
+| `paths` | Files/globs to sync (`src_path` required, `dest_path` optional) |
+| `destinations` | Target repos with sync settings |
+| `header_config` | Comment style per extension (has defaults) |
+| `pr_defaults` | PR title, labels, reviewers, assignees |
+
+## Header Format
+
+Synced files have a header comment identifying the source config:
+
+```python
+# path-sync copy -n myconfig
+```
+
+Comment style is extension-aware:
+
+| Extension | Format |
+|-----------|--------|
+| `.py`, `.sh`, `.yaml` | `# path-sync copy -n {name}` |
+| `.go`, `.js`, `.ts` | `// path-sync copy -n {name}` |
+| `.md`, `.mdc`, `.html` | `<!-- path-sync copy -n {name} -->` |
+
+Remove this header to opt-out of future syncs for that file.
+
+## GitHub Actions
+
+### Source repo workflow
+
+Create `.github/workflows/path_sync_copy.yaml`:
+
+```yaml
+name: path-sync copy
+on:
+  schedule:
+    - cron: "0 6 * * *"
+  workflow_dispatch:
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uvx path-sync copy -n myconfig --checkout-from-default -y
+        env:
+          GH_TOKEN: ${{ secrets.GH_PAT }}
+```
+
+### Destination repo validation
+
+Create `.github/workflows/path_sync_validate.yaml`:
+
+```yaml
+name: path-sync validate
+on:
+  push:
+    branches-ignore:
+      - main
+      - sync/**
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v5
+      - run: uvx path-sync validate-no-changes -b main
+```
+
+**Validation skips automatically when:**
+- On a `sync/*` branch (path-sync uses `sync/path-sync` by default)
+- On the default branch (comparing against itself)
+
+The workflow triggers exclude these branches too, reducing unnecessary CI runs.
+
+### PAT Requirements
+
+Create a **Fine-grained PAT** at <https://github.com/settings/tokens?type=beta>
+
+| Permission | Scope |
+|------------|-------|
+| Contents | Read/write (push branches) |
+| Pull requests | Read/write (create PRs) |
+| Workflows | Read/write (if syncing `.github/workflows/`) |
+| Metadata | Read (always required) |
+
+Add as repository secret: `GH_PAT`
+
+### Common Errors
+
+| Error | Fix |
+|-------|-----|
+| `HTTP 404: Not Found` | Add repo to PAT's repository access |
+| `HTTP 403: Resource not accessible` | Add Contents + Pull requests permissions |
+| `GraphQL: Resource not accessible` | Use GH_PAT, not GITHUB_TOKEN |
+| `HTTP 422: Required status check` | Exclude `sync/*` from branch protection |
+
+## Alternatives Considered
+
+| Tool | Why Not |
+|------|---------|
+| [repo-file-sync-action](https://github.com/BetaHuhn/repo-file-sync-action) | No local CLI, no validation |
+| [Copier](https://copier.readthedocs.io/) | Merge-based (conflicts), no multi-dest |
+| [Cruft](https://cruft.github.io/cruft/) | Patch-based, single dest |
+
+**Why path-sync:**
+- One SRC to many DEST repos
+- Local CLI + CI support
+- Section-level sync for shared files
+- Validation enforced across repos
+- Clear ownership (no merge conflicts)

{path_sync-0.1.0.dist-info → path_sync-0.2.1.dist-info}/RECORD

@@ -1,24 +1,23 @@
 path_sync/__init__.py,sha256=fdUhqFKjflvMkVbUuA_RMMv4am652KWK8N3IVQzj6ok,63
 path_sync/__main__.py,sha256=Hh0Na0BlS0EwBAerhWD4mnaB-oMo6jufFVQBuzNZk3g,296
-path_sync/cmd_boot.py,sha256=sN5NKVDLfo7uNvJuNw3dFK1LhjWd8CuhTWByu70Z_EI,3577
-path_sync/cmd_copy.py,sha256=sK1Gpf3ag7vouXZuyhdJjyvfXvP_Lt694s0DEmUhs40,16872
-path_sync/cmd_copy_test.py,sha256=Dq8NjDOo9cuY1YnnM1zW0ETVv9w_o1ECgOkBntnF_N4,3858
-path_sync/cmd_validate.py,sha256=Fv33Md730mecs2pH4S9Yew7AvI1aZ-LQ8ozcZ1jzhVw,1505
+path_sync/cmd_boot.py,sha256=hYSrMF9QHVXX5feO2UE3lFSJvV38tEsJaNl0sjU2gbw,2896
+path_sync/cmd_copy.py,sha256=RcIv3s6HDiOHU3Z1Q5HYzVIOGDc_4cYqYGyj9Gpnjlk,15701
+path_sync/cmd_copy_test.py,sha256=dcpRaFAmXuUavIvtA59_In4Fa58FKRklNcYmeGsEuVA,5049
+path_sync/cmd_validate.py,sha256=wcMo_JR2jxFtqaNQt1mk_Mnwy_jPSpFHCXFuzNOphEU,1624
 path_sync/conftest.py,sha256=-iu7W2Bh2aRzTR1x3aMnkWkrVnDMp6ezdh1AFgNcYUE,343
 path_sync/file_utils.py,sha256=5C33qzKFQdwChi5YwUWBujj126t0P6dbGSU_5hWExpE,194
 path_sync/git_ops.py,sha256=1ixXKtseZAWAJP9uJcAb78IGQOmRekriv-n_T1nx0mI,5945
 path_sync/header.py,sha256=2YSCj7ainj5TPFINBHn8Uc2ECu591pZfd7NSOZMX5XA,2293
 path_sync/header_test.py,sha256=R9jwOulSKR70HrFoxYBXUx3DGjdzfB2tZNu9sjL_3rA,1401
-path_sync/models.py,sha256=aI9ypIj1W6aWf-GcRayu1uIXypfkQSsIeKXrf5Vb7V4,4196
+path_sync/models.py,sha256=GR2J8PRtAORltvnL73In6zjdNbkELtUomHdwPHfsWwU,3832
 path_sync/models_test.py,sha256=m9kZbl3CGABrg58owNLx4Aiv5LPvKz0t61o0336J5x8,2052
 path_sync/sections.py,sha256=jzzzt2e-umjY0Ab-d7W-29y7aVVBtf_vEX_abFEdZdo,3681
 path_sync/sections_test.py,sha256=lsApYMe1BqGL7T0sYhbs28VCrDm9dmkq0G3JAvGOlPI,3546
 path_sync/typer_app.py,sha256=lEGMRXql3Se3VbmwAohvpUaL2cbY-RwhPUq8kL7bPbc,177
 path_sync/validation.py,sha256=RP9SWd69mGvB4MxGx4RFJiyIQ-X482Y5h7G7VYAOxiE,2766
 path_sync/validation_test.py,sha256=NdK1JHAtjGIm7m7uVm0fM751ttJhKXrS21gt1eEDhP0,3071
-path_sync/workflow_gen.py,sha256=YkgXt3YD0Bi41fjHe1NgjL6FsAcviM_QaEKpCB4WVNo,3732
 path_sync/yaml_utils.py,sha256=yj6Bl54EltjLEcVKaiA5Ahb9byT6OUMh0xIEzTsrvnQ,498
-path_sync-0.1.0.dist-info/METADATA,sha256=OxFqeFx5sgyiFS-rkAilm2Bh20oGcB8TyslrW3l68Hg,6652
-path_sync-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-path_sync-0.1.0.dist-info/entry_points.txt,sha256=jTsL0c-9gP-4_Jt3EPgihtpLcwQR0AFAf1AUpD50AlI,54
-path_sync-0.1.0.dist-info/RECORD,,
+path_sync-0.2.1.dist-info/METADATA,sha256=4-DnsGErtoA24qkvnBMXK4HuKm7YR-ZhX4FZ5h2zXXQ,7785
+path_sync-0.2.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+path_sync-0.2.1.dist-info/entry_points.txt,sha256=jTsL0c-9gP-4_Jt3EPgihtpLcwQR0AFAf1AUpD50AlI,54
+path_sync-0.2.1.dist-info/RECORD,,

path_sync/workflow_gen.py

@@ -1,130 +0,0 @@
-from __future__ import annotations
-
-import logging
-from enum import StrEnum
-from pathlib import Path
-
-from path_sync.models import SrcConfig
-
-logger = logging.getLogger(__name__)
-
-COPY_WORKFLOW_TEMPLATE = """name: "Path Sync: {name} copy"
-
-on:
-  workflow_dispatch:
-    inputs:
-      dest:
-        description: "Filter destinations (comma-separated)"
-        required: false
-        default: ""
-      extra_args:
-        description: "Extra args for path-sync copy"
-        required: false
-        default: ""
-  schedule:
-    - cron: "{schedule}"
-
-jobs:
-  sync:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v4
-      - name: Run path-sync copy
-        env:
-          GH_TOKEN: ${{{{ secrets.GH_PAT }}}}
-        run: |
-          ARGS="-n {name}"
-          if [ -n "${{{{ inputs.dest }}}}" ]; then
-            ARGS="$ARGS -d ${{{{ inputs.dest }}}}"
-          fi
-          if [ -n "${{{{ inputs.extra_args }}}}" ]; then
-            ARGS="$ARGS ${{{{ inputs.extra_args }}}}"
-          fi
-          uv run path-sync copy $ARGS
-"""
-
-WHEEL_GLOB = ".github/path_sync-*.whl"
-
-VALIDATE_WORKFLOW_TEMPLATE = """name: "Path Sync: {name} validate"
-
-on:
-  push:
-    branches-ignore:
-      - "{copy_branch}"
-      - "{default_branch}"
-
-jobs:
-  validate:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v4
-      - name: Validate no unauthorized changes
-        run: uv run --with {wheel_glob} path-sync validate-no-changes -n {name}
-"""
-
-
-def generate_copy_workflow(config: SrcConfig) -> str:
-    return COPY_WORKFLOW_TEMPLATE.format(name=config.name, schedule=config.schedule)
-
-
-def generate_validate_workflow(name: str, copy_branch: str, default_branch: str) -> str:
-    return VALIDATE_WORKFLOW_TEMPLATE.format(
-        name=name,
-        copy_branch=copy_branch,
-        default_branch=default_branch,
-        wheel_glob=WHEEL_GLOB,
-    )
-
-
-def copy_workflow_path(name: str) -> str:
-    return f".github/workflows/path_sync_{name}_copy.yaml"
-
-
-def validate_workflow_path(name: str) -> str:
-    return f".github/workflows/path_sync_{name}_validate.yaml"
-
-
-class JustfileRecipeKind(StrEnum):
-    COPY = "copy"
-    VALIDATE = "validate"
-
-    def recipe_name(self, config_name: str) -> str:
-        if self == JustfileRecipeKind.COPY:
-            return f"path-sync-{config_name}"
-        return f"path-sync-validate-{config_name}"
-
-    def generate_recipe(self, config_name: str) -> str:
-        recipe_name = self.recipe_name(config_name)
-        if self == JustfileRecipeKind.COPY:
-            return f"\n# path-sync: copy files to destinations\n{recipe_name}:\n    uv run path-sync copy -n {config_name}\n"
-        return f"\n# path-sync: validate no unauthorized changes\n{recipe_name}:\n    uv run --with {WHEEL_GLOB} path-sync validate-no-changes -n {config_name}\n"
-
-
-def update_justfile(
-    justfile_path: Path,
-    config_name: str,
-    kind: JustfileRecipeKind,
-    dry_run: bool,
-) -> bool:
-    """Update justfile with recipe. Returns True if changes were made."""
-    recipe = kind.generate_recipe(config_name)
-    recipe_marker = f"{kind.recipe_name(config_name)}:"
-
-    if justfile_path.exists():
-        existing = justfile_path.read_text()
-        if recipe_marker in existing:
-            logger.info(f"Justfile recipe already exists: {recipe_marker}")
-            return False
-        new_content = existing.rstrip() + recipe
-    else:
-        new_content = recipe.lstrip()
-
-    if dry_run:
-        logger.info(f"[DRY RUN] Would update justfile with recipe: {recipe_marker}")
-        return True
-
-    justfile_path.write_text(new_content)
-    logger.info(f"Added justfile recipe: {recipe_marker}")
-    return True

path_sync-0.1.0.dist-info/METADATA

@@ -1,200 +0,0 @@
-Metadata-Version: 2.4
-Name: path-sync
-Version: 0.1.0
-Author-email: EspenAlbert <espen.albert1@gmail.com>
-License-Expression: MIT
-Classifier: Development Status :: 4 - Beta
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.13
-Requires-Dist: gitpython>=3.1.0
-Requires-Dist: pydantic>=2.0
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: typer>=0.16.0
-Description-Content-Type: text/markdown
-
-# path-sync
-
-Sync files from a source repo to multiple destination repos.
-
-## Installation
-
-```bash
-uv pip install -e path-sync/
-```
-
-## Quick Start
-
-### 1. Bootstrap a source config
-
-```bash
-# From your source repo root
-path-sync boot -n myconfig -d ../dest-repo1 -d ../dest-repo2 -p '.cursor/**/*.mdc'
-```
-
-Creates `.github/myconfig.src.yaml` with:
-- Auto-detected `src_repo_url` from git remote
-- Destinations with names extracted from paths
-- Always paths from `-p` patterns
-
-### 2. Copy files to destinations
-
-```bash
-path-sync copy -n myconfig
-```
-
-Options:
-- `-d lz,help` - filter specific destinations
-- `--dry-run` - preview without changes
-- `--validate-first` - run validation before copying
-- `--skip-dest-checkout` - use current branch in dest
-- `--force-ignore-sha-match` - re-copy even if SHA unchanged
-- `--force-no-header-updates` - overwrite files even if header removed (opted out)
-- `--no-pr` - skip PR creation
-
-### 3. Validate no unauthorized changes (run in dest repo)
-
-```bash
-# If path-sync is installed
-path-sync validate-no-changes -n myconfig
-
-# Or using the copied wheel (no installation needed)
-uv run --with .github/path_sync-*.whl path-sync validate-no-changes -n myconfig
-```
-
-### 4. Clean orphaned synced files (run in dest repo)
-
-```bash
-path-sync clean
-```
-
-## Config Structure
-
-**Source config** (`.github/{name}.src.yaml`):
-```yaml
-type: SRC
-name: cursor
-src_repo_url: https://github.com/user/src-repo
-schedule: "0 6 * * *"
-always_paths:
-  - src_path: .cursor/**/*.mdc
-scaffold_paths:
-  - src_path: templates/README.md
-destinations:
-  - name: dest1
-    repo_url: https://github.com/user/dest1
-    dest_path_relative: ../dest1
-    copy_branch: sync/path-sync
-    default_branch: main
-    tools_update:
-      justfile: true           # Add validate recipe to justfile
-      path_sync_wheel: true    # Copy path-sync wheel to .github/
-      github_workflows: true   # Generate validation workflow
-```
-
-## Opt-out Mechanism
-
-Synced files have a header comment (e.g., `<!-- DO NOT EDIT: path-sync destination file -->`).
-Remove this header to opt-out of future syncs for that file.
-
-## Header Configuration
-
-The header text and comment styles are configurable in `header_config`:
-
-```yaml
-header_config:
-  header_text: "DO NOT EDIT: path-sync destination file"  # customize message
-  comment_prefixes:    # extension -> prefix mapping
-    .py: "#"
-    .md: "<!--"
-  comment_suffixes:    # optional closing (for HTML-style comments)
-    .md: " -->"
-```
-
-**Behavior:**
-- **Defaults included**: Running `boot` generates config with all supported extensions pre-configured
-- **Inherited by DEST**: The `header_config` from SRC is copied to DEST config during `copy`
-- **Only configured extensions synced**: Files with extensions not in `comment_prefixes` are skipped
-- **Validation uses DEST config**: The `validate-no-changes` and `clean` commands read header config from the dest config
-
-**Supported extensions (defaults):**
-
-| Extension | Prefix | Suffix |
-|-----------|--------|--------|
-| `.py`, `.sh`, `.yaml`, `.yml` | `#` | |
-| `.go`, `.js`, `.ts` | `//` | |
-| `.md`, `.mdc`, `.html` | `<!--` | `-->` |
-
-## GitHub Actions
-
-**Source repo**: Set `src_tools_update.github_workflows: true` and run `boot --regen` to generate:
-- `.github/workflows/path_sync_{name}_copy.yaml` - scheduled sync workflow
-
-**Destination repos**: Set `tools_update.github_workflows: true` per destination to auto-generate:
-- `.github/workflows/path_sync_{name}_validate.yaml` - validation on push (uses the copied wheel)
-
-### PAT Requirements
-
-Create a **Fine-grained Personal Access Token** at <https://github.com/settings/tokens?type=beta>
-
-**Repository access**: Select each destination repository
-
-**Permissions required per destination repo**:
-- **Contents**: Read and write (push branches)
-- **Pull requests**: Read and write (create PRs)
-- **Workflows**: Read and write (required if syncing workflow files to `.github/workflows/`)
-- **Metadata**: Read (always required)
-
-**Classic PAT alternative**: Use `repo` + `workflow` scopes
-
-### Setup
-
-1. Create the PAT with permissions above
-2. Add as repository secret: Settings > Secrets > Actions > `GH_PAT`
-3. The workflow uses `GH_TOKEN: ${{ secrets.GH_PAT }}` for `gh` CLI auth
-
-### Verify Access
-
-```bash
-# Test from any machine with gh CLI
-export GH_TOKEN=your_pat
-gh api repos/owner/dest-repo
-gh pr list --repo owner/dest-repo
-```
-
-### Branch Protection
-
-The `copy_branch` (default: `sync/path-sync`) is where path-sync pushes changes. This branch typically doesn't need protection rules.
-
-**Potential issues**:
-- If wildcard branch protection (e.g., `*`) blocks pushes, exclude `sync/*` pattern
-- Required status checks on the PR target branch may delay merge
-
-**Workarounds**:
-- Add `sync/path-sync` to branch protection bypass list
-- Or use a bot/machine user account with bypass permissions
-- The `--no-pr` flag skips PR creation if you prefer manual work
-
-### Common Errors
-
-| Error | Cause | Fix |
-|-------|-------|-----|
-| `HTTP 404: Not Found` | PAT lacks repo access | Add repo to PAT's repository access |
-| `HTTP 403: Resource not accessible` | Missing permission | Add Contents + Pull requests permissions |
-| `GraphQL: Resource not accessible by integration` | Using GITHUB_TOKEN | Use GH_PAT secret instead |
-| `HTTP 422: Required status check` | Branch protection rules | Bypass or exclude `sync/*` branches |
-
-## Alternatives Considered
-
-| Tool | Description | Why Not |
-|------|-------------|---------|
-| [repo-file-sync-action](https://github.com/BetaHuhn/repo-file-sync-action) | GitHub Action for file sync | No local CLI, no validation workflow, no justfile support |
-| [Copier](https://copier.readthedocs.io/) | Template-based project generation | Merge-based (both SRC and DEST can edit), no multi-dest, no validation |
-| [Cruft](https://cruft.github.io/cruft/) | Cookiecutter with updates | Patch-based merging, single dest, no CI validation |
-
-**Why path-sync:**
-- One SRC to multiple DEST repos (not 1:1)
-- Local CLI support (not GitHub Action only)
-- Justfile integration for dev workflow
-- Validation checks enforced across many repos
-- Clear ownership: SRC or DEST, never both (no merge conflicts)