continuous-refactoring 0.1.0__tar.gz → 0.2.0__tar.gz

{continuous_refactoring-0.1.0 → continuous_refactoring-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: continuous-refactoring
-Version: 0.1.0
+Version: 0.2.0
 Summary: Continuous refactoring loop for AI coding agents
 Project-URL: Repository, https://github.com/bigH/continuous-refactoring
 Project-URL: Issues, https://github.com/bigH/continuous-refactoring/issues
@@ -23,16 +23,41 @@ Description-Content-Type: text/markdown
 
 # continuous-refactoring
 
+[![GitHub repo](https://img.shields.io/badge/github-repo-green)](https://github.com/bigH/continuous-refactoring)
+[![PyPI](https://img.shields.io/pypi/v/continuous-refactoring.svg)](https://pypi.org/project/continuous-refactoring/)
+[![Tests](https://github.com/bigH/continuous-refactoring/actions/workflows/test.yml/badge.svg)](https://github.com/bigH/continuous-refactoring/actions/workflows/test.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/bigH/continuous-refactoring/blob/main/LICENSE)
+
 Small, test-gated cleanup commits by an AI coding agent.
 
 Think of it as a supervised janitor loop: the agent proposes a cleanup, your tests decide if it stays.
 
 ## Install
 
+Try it without installing:
+
+```bash
+uvx continuous-refactoring --help
+```
+
+Or install it with [uv](https://docs.astral.sh/uv/guides/tools/):
+
 ```bash
 uv tool install continuous-refactoring
 ```
 
+Or with [pipx](https://pypa.github.io/pipx/):
+
+```bash
+pipx install continuous-refactoring
+```
+
+Or with pip:
+
+```bash
+pip install continuous-refactoring
+```
+
 For a checkout:
 
 ```bash
@@ -89,6 +114,8 @@ That keeps sweeping targets until it runs out, hits your caps, or starts failing
 ```bash
 # 1. Register the repo (creates a project dir under ~/.local/share/continuous-refactoring)
 continuous-refactoring init
+# Or keep project taste in the repo:
+continuous-refactoring init --in-repo-taste
 
 # 2. (Optional) Write your refactoring taste — either edit the file, have an agent interview you,
 #    or refine an existing draft collaboratively
@@ -113,7 +140,7 @@ continuous-refactoring run \
 
 | Command | What it does |
 |---|---|
-| `init` | Registers this directory as a project, creates a default `taste.md`, and can store `--live-migrations-dir`. |
+| `init` | Registers this directory as a project, creates a default `taste.md`, and can store `--live-migrations-dir` or `--in-repo-taste`. |
 | `taste` | Prints the active taste file path. Add `--interview` to have an agent author it, `--refine` to iteratively improve an existing taste doc, `--upgrade` to refresh stale taste dimensions, `--global` for the shared file, and `--force` to let `--interview` overwrite custom content after writing a `.bak`. |
 | `run-once` | Single pass on one resolved target. No retry. If there is a diff and validation passes, it commits locally and prints the diffstat. |
 | `run` | The loop. Iterates targets, retries on failure, and commits successful targets locally. |
@@ -141,6 +168,7 @@ If you provide none of `--targets`, `--globs`, `--extensions`, or `--paths`, the
 ### Migrations & taste flags
 
 - `init --live-migrations-dir PATH` — enables the larger-refactoring workflow for this project. The path is stored repo-relative in the project registry and created if missing.
+- `init --in-repo-taste [PATH]` — stores this project's taste file in the repo and remembers the repo-relative path. Defaults to `.continuous-refactoring/taste.md`; re-run `init --in-repo-taste ...` to choose a different path.
 - `taste --refine` — opens a collaborative editing session for the taste file. The agent keeps refining until you tell it to write, then the session ends automatically after the settled write.
 - `taste --upgrade` — re-interviews for taste dimensions added since your last version. No-op when already current; use `taste --refine` if you want to rework the doc anyway.
 - `taste --force` — only applies to `--interview`; it allows a customized taste file to be overwritten after backing it up to `taste.md.bak`.
@@ -191,10 +219,10 @@ The path prints at startup. Grep it when something goes sideways.
 
 The taste file is a short bullet list of your refactoring preferences. It gets injected into every agent prompt.
 
-- Project taste: `~/.local/share/continuous-refactoring/projects/<uuid>/taste.md`
+- Project taste: `~/.local/share/continuous-refactoring/projects/<uuid>/taste.md`, or the repo-local path chosen with `init --in-repo-taste [PATH]`
 - Global taste: `~/.local/share/continuous-refactoring/global/taste.md`
 
-Project taste wins over global. Use `taste --interview` to bootstrap one, `taste --refine` to rework it with an agent, or edit the file directly any time.
+Project taste wins over global. Use `taste` to print the active path, `taste --interview` to bootstrap one, `taste --refine` to rework it with an agent, or edit the file directly any time.
 
 ## Larger refactorings
 

{continuous_refactoring-0.1.0 → continuous_refactoring-0.2.0}/README.md

@@ -1,15 +1,40 @@
 # continuous-refactoring
 
+[![GitHub repo](https://img.shields.io/badge/github-repo-green)](https://github.com/bigH/continuous-refactoring)
+[![PyPI](https://img.shields.io/pypi/v/continuous-refactoring.svg)](https://pypi.org/project/continuous-refactoring/)
+[![Tests](https://github.com/bigH/continuous-refactoring/actions/workflows/test.yml/badge.svg)](https://github.com/bigH/continuous-refactoring/actions/workflows/test.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/bigH/continuous-refactoring/blob/main/LICENSE)
+
 Small, test-gated cleanup commits by an AI coding agent.
 
 Think of it as a supervised janitor loop: the agent proposes a cleanup, your tests decide if it stays.
 
 ## Install
 
+Try it without installing:
+
+```bash
+uvx continuous-refactoring --help
+```
+
+Or install it with [uv](https://docs.astral.sh/uv/guides/tools/):
+
 ```bash
 uv tool install continuous-refactoring
 ```
 
+Or with [pipx](https://pypa.github.io/pipx/):
+
+```bash
+pipx install continuous-refactoring
+```
+
+Or with pip:
+
+```bash
+pip install continuous-refactoring
+```
+
 For a checkout:
 
 ```bash
@@ -66,6 +91,8 @@ That keeps sweeping targets until it runs out, hits your caps, or starts failing
 ```bash
 # 1. Register the repo (creates a project dir under ~/.local/share/continuous-refactoring)
 continuous-refactoring init
+# Or keep project taste in the repo:
+continuous-refactoring init --in-repo-taste
 
 # 2. (Optional) Write your refactoring taste — either edit the file, have an agent interview you,
 #    or refine an existing draft collaboratively
@@ -90,7 +117,7 @@ continuous-refactoring run \
 
 | Command | What it does |
 |---|---|
-| `init` | Registers this directory as a project, creates a default `taste.md`, and can store `--live-migrations-dir`. |
+| `init` | Registers this directory as a project, creates a default `taste.md`, and can store `--live-migrations-dir` or `--in-repo-taste`. |
 | `taste` | Prints the active taste file path. Add `--interview` to have an agent author it, `--refine` to iteratively improve an existing taste doc, `--upgrade` to refresh stale taste dimensions, `--global` for the shared file, and `--force` to let `--interview` overwrite custom content after writing a `.bak`. |
 | `run-once` | Single pass on one resolved target. No retry. If there is a diff and validation passes, it commits locally and prints the diffstat. |
 | `run` | The loop. Iterates targets, retries on failure, and commits successful targets locally. |
@@ -118,6 +145,7 @@ If you provide none of `--targets`, `--globs`, `--extensions`, or `--paths`, the
 ### Migrations & taste flags
 
 - `init --live-migrations-dir PATH` — enables the larger-refactoring workflow for this project. The path is stored repo-relative in the project registry and created if missing.
+- `init --in-repo-taste [PATH]` — stores this project's taste file in the repo and remembers the repo-relative path. Defaults to `.continuous-refactoring/taste.md`; re-run `init --in-repo-taste ...` to choose a different path.
 - `taste --refine` — opens a collaborative editing session for the taste file. The agent keeps refining until you tell it to write, then the session ends automatically after the settled write.
 - `taste --upgrade` — re-interviews for taste dimensions added since your last version. No-op when already current; use `taste --refine` if you want to rework the doc anyway.
 - `taste --force` — only applies to `--interview`; it allows a customized taste file to be overwritten after backing it up to `taste.md.bak`.
@@ -168,10 +196,10 @@ The path prints at startup. Grep it when something goes sideways.
 
 The taste file is a short bullet list of your refactoring preferences. It gets injected into every agent prompt.
 
-- Project taste: `~/.local/share/continuous-refactoring/projects/<uuid>/taste.md`
+- Project taste: `~/.local/share/continuous-refactoring/projects/<uuid>/taste.md`, or the repo-local path chosen with `init --in-repo-taste [PATH]`
 - Global taste: `~/.local/share/continuous-refactoring/global/taste.md`
 
-Project taste wins over global. Use `taste --interview` to bootstrap one, `taste --refine` to rework it with an agent, or edit the file directly any time.
+Project taste wins over global. Use `taste` to print the active path, `taste --interview` to bootstrap one, `taste --refine` to rework it with an agent, or edit the file directly any time.
 
 ## Larger refactorings
 

{continuous_refactoring-0.1.0 → continuous_refactoring-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "continuous-refactoring"
-version = "0.1.0"
+version = "0.2.0"
 description = "Continuous refactoring loop for AI coding agents"
 readme = "README.md"
 requires-python = ">=3.10"

{continuous_refactoring-0.1.0 → continuous_refactoring-0.2.0}/src/continuous_refactoring/cli.py

@@ -1,7 +1,9 @@
 from __future__ import annotations
 
 import argparse
+import shutil
 import sys
+import uuid
 from collections.abc import Callable
 from pathlib import Path
 
@@ -102,6 +104,8 @@ def _add_common_args(parser: argparse.ArgumentParser) -> None:
 
 
 def _add_init_parser(subparsers: argparse._SubParsersAction) -> None:
+    from continuous_refactoring.config import DEFAULT_REPO_TASTE_PATH
+
     init_parser = subparsers.add_parser(
         "init",
         help="Register a project for continuous refactoring.",
@@ -119,6 +123,23 @@ def _add_init_parser(subparsers: argparse._SubParsersAction) -> None:
         default=None,
         help="Directory for live migration artifacts (repo-relative path).",
     )
+    init_parser.add_argument(
+        "--in-repo-taste",
+        type=Path,
+        nargs="?",
+        const=Path(DEFAULT_REPO_TASTE_PATH),
+        default=None,
+        metavar="PATH",
+        help=(
+            "Store this project's taste file in the repo. "
+            f"Defaults to {DEFAULT_REPO_TASTE_PATH}."
+        ),
+    )
+    init_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Replace destination state when reconfiguring taste or live migrations.",
+    )
 
 
 def _add_taste_parser(subparsers: argparse._SubParsersAction) -> None:
@@ -273,16 +294,39 @@ def _handle_init(args: argparse.Namespace) -> None:
     from continuous_refactoring.config import (
         ensure_taste_file,
         register_project,
+        resolve_live_migrations_dir,
+        resolve_project,
+        resolve_project_taste_path,
         set_live_migrations_dir,
+        set_repo_taste_path,
     )
 
     path = (args.path or Path.cwd()).resolve()
+    in_repo_taste_arg: Path | None = getattr(args, "in_repo_taste", None)
+    live_dir_arg: Path | None = getattr(args, "live_migrations_dir", None)
+    force = bool(getattr(args, "force", False))
+    repo_taste_relative: str | None = None
+    repo_taste_resolved: Path | None = None
+    resolved_live: Path | None = None
+    live_dir_relative: str | None = None
+
     try:
-        project = register_project(path)
-        taste_path = project.project_dir / "taste.md"
-        ensure_taste_file(taste_path)
+        if in_repo_taste_arg is not None:
+            repo_taste_resolved = (path / in_repo_taste_arg).resolve()
+            if not repo_taste_resolved.is_relative_to(path):
+                print(
+                    f"Error: --in-repo-taste must be inside the repo: {in_repo_taste_arg}",
+                    file=sys.stderr,
+                )
+                raise SystemExit(2)
+            if repo_taste_resolved.exists() and not repo_taste_resolved.is_file():
+                print(
+                    f"Error: --in-repo-taste must point to a file: {in_repo_taste_arg}",
+                    file=sys.stderr,
+                )
+                raise SystemExit(2)
+            repo_taste_relative = str(repo_taste_resolved.relative_to(path))
 
-        live_dir_arg: Path | None = getattr(args, "live_migrations_dir", None)
         if live_dir_arg is not None:
             resolved_live = (path / live_dir_arg).resolve()
             if not resolved_live.is_relative_to(path):
@@ -291,9 +335,39 @@ def _handle_init(args: argparse.Namespace) -> None:
                     file=sys.stderr,
                 )
                 raise SystemExit(2)
-            relative = str(resolved_live.relative_to(path))
-            resolved_live.mkdir(parents=True, exist_ok=True)
-            set_live_migrations_dir(project.entry.uuid, relative)
+            if resolved_live.exists() and not resolved_live.is_dir():
+                print(
+                    f"Error: --live-migrations-dir must point to a directory: {live_dir_arg}",
+                    file=sys.stderr,
+                )
+                raise SystemExit(2)
+            live_dir_relative = str(resolved_live.relative_to(path))
+
+        project = register_project(path)
+        if repo_taste_relative is not None:
+            assert repo_taste_resolved is not None
+            _configure_repo_taste(
+                current=resolve_project_taste_path(project),
+                destination=repo_taste_resolved,
+                force=force,
+                ensure_taste_file=ensure_taste_file,
+            )
+            set_repo_taste_path(project.entry.uuid, repo_taste_relative)
+            project = resolve_project(path)
+
+        taste_path = resolve_project_taste_path(project)
+        ensure_taste_file(taste_path)
+
+        if live_dir_arg is not None:
+            assert resolved_live is not None
+            assert live_dir_relative is not None
+            _configure_live_migrations_dir(
+                current=resolve_live_migrations_dir(project),
+                destination=resolved_live,
+                force=force,
+            )
+            set_live_migrations_dir(project.entry.uuid, live_dir_relative)
+            project = resolve_project(path)
     except ContinuousRefactorError as error:
         print(f"Error: {error}", file=sys.stderr)
         raise SystemExit(1) from error
@@ -302,11 +376,110 @@ def _handle_init(args: argparse.Namespace) -> None:
     print(f"Data directory: {project.project_dir}")
     print(f"Taste file: {taste_path}")
     if live_dir_arg is not None:
+        assert resolved_live is not None
         print(f"Live migrations dir: {resolved_live}")
 
 
+def _configure_repo_taste(
+    *,
+    current: Path,
+    destination: Path,
+    force: bool,
+    ensure_taste_file: Callable[[Path], Path],
+) -> None:
+    if not current.exists():
+        ensure_taste_file(destination)
+        return
+    if current.resolve() == destination.resolve():
+        return
+    if not current.is_file():
+        raise ContinuousRefactorError(
+            f"Configured taste path is not a file: {current}"
+        )
+    if destination.exists() and not force:
+        raise ContinuousRefactorError(
+            "Taste destination already exists: "
+            f"{destination}. Re-run init with --force to replace it."
+        )
+
+    destination.parent.mkdir(parents=True, exist_ok=True)
+    try:
+        shutil.move(str(current), str(destination))
+    except OSError as exc:
+        raise ContinuousRefactorError(
+            f"Could not move taste file from {current} to {destination}."
+        ) from exc
+
+
+def _configure_live_migrations_dir(
+    *,
+    current: Path | None,
+    destination: Path,
+    force: bool,
+) -> None:
+    if current is None or not current.exists():
+        destination.mkdir(parents=True, exist_ok=True)
+        return
+    if not current.is_dir():
+        raise ContinuousRefactorError(
+            f"Configured live migrations path is not a directory: {current}"
+        )
+    if current.resolve() == destination.resolve():
+        return
+    if (
+        destination.resolve().is_relative_to(current.resolve())
+        or current.resolve().is_relative_to(destination.resolve())
+    ):
+        raise ContinuousRefactorError(
+            "Live migrations directory cannot be moved into itself or one of "
+            f"its parents: {current} -> {destination}"
+        )
+
+    backup_destination: Path | None = None
+    removed_empty_destination = False
+    if destination.exists():
+        if not destination.is_dir():
+            raise ContinuousRefactorError(
+                f"Live migrations destination is not a directory: {destination}"
+            )
+        if any(destination.iterdir()) and not force:
+            raise ContinuousRefactorError(
+                "Live migrations destination already exists and is not empty: "
+                f"{destination}. Re-run init with --force to replace it."
+            )
+        if force:
+            backup_name = (
+                f".{destination.name}."
+                f"continuous-refactoring-replaced-{uuid.uuid4().hex}"
+            )
+            backup_destination = destination.with_name(backup_name)
+            destination.rename(backup_destination)
+        else:
+            destination.rmdir()
+            removed_empty_destination = True
+
+    destination.parent.mkdir(parents=True, exist_ok=True)
+    try:
+        shutil.move(str(current), str(destination))
+    except OSError as exc:
+        if backup_destination is not None and not destination.exists():
+            backup_destination.rename(destination)
+        elif removed_empty_destination:
+            destination.mkdir(parents=True, exist_ok=True)
+        raise ContinuousRefactorError(
+            "Could not move live migrations directory from "
+            f"{current} to {destination}."
+        ) from exc
+    if backup_destination is not None:
+        shutil.rmtree(backup_destination, ignore_errors=True)
+
+
 def _resolve_taste_path(global_: bool) -> Path:
-    from continuous_refactoring.config import global_dir, resolve_project
+    from continuous_refactoring.config import (
+        global_dir,
+        resolve_project,
+        resolve_project_taste_path,
+    )
 
     if global_:
         path = global_dir() / "taste.md"
@@ -323,7 +496,7 @@ def _resolve_taste_path(global_: bool) -> Path:
             file=sys.stderr,
         )
         raise SystemExit(1) from error
-    return project.project_dir / "taste.md"
+    return resolve_project_taste_path(project)
 
 
 def _taste_settle_path(path: Path) -> Path:

{continuous_refactoring-0.1.0 → continuous_refactoring-0.2.0}/src/continuous_refactoring/config.py

@@ -14,6 +14,7 @@ from continuous_refactoring.artifacts import ContinuousRefactorError
 
 __all__ = [
     "CONFIG_CURRENT_VERSION",
+    "DEFAULT_REPO_TASTE_PATH",
     "ProjectEntry",
     "ResolvedProject",
     "TASTE_CURRENT_VERSION",
@@ -31,15 +32,18 @@ __all__ = [
     "parse_taste_version",
     "register_project",
     "resolve_live_migrations_dir",
+    "resolve_project_taste_path",
     "resolve_project",
     "save_manifest",
     "set_live_migrations_dir",
+    "set_repo_taste_path",
     "taste_is_stale",
     "xdg_data_home",
 ]
 
 CONFIG_CURRENT_VERSION = 1
 TASTE_CURRENT_VERSION = 1
+DEFAULT_REPO_TASTE_PATH = ".continuous-refactoring/taste.md"
 
 _DEFAULT_TASTE = """\
 taste-scoping-version: 1
@@ -69,6 +73,7 @@ class ProjectEntry:
     git_remote: str | None
     created_at: str
     live_migrations_dir: str | None = None
+    repo_taste_path: str | None = None
 
 
 @dataclass(frozen=True)
@@ -182,6 +187,12 @@ def _entry_from_object(uid: str, data: object) -> ProjectEntry:
             project_id=uid,
             required=False,
         ),
+        repo_taste_path=_string_field(
+            data,
+            "repo_taste_path",
+            project_id=uid,
+            required=False,
+        ),
     )
 
 
@@ -310,6 +321,18 @@ def resolve_live_migrations_dir(project: ResolvedProject) -> Path | None:
     return resolved
 
 
+def resolve_project_taste_path(project: ResolvedProject) -> Path:
+    if project.entry.repo_taste_path is None:
+        return project.project_dir / "taste.md"
+    repo_root = Path(project.entry.path).resolve()
+    resolved = (repo_root / project.entry.repo_taste_path).resolve()
+    if not resolved.is_relative_to(repo_root):
+        raise ContinuousRefactorError(
+            f"repo_taste_path escapes repo: {project.entry.repo_taste_path}"
+        )
+    return resolved
+
+
 def _get_project(manifest: dict[str, ProjectEntry], project_uuid: str) -> ProjectEntry:
     project = manifest.get(project_uuid)
     if project is None:
@@ -324,6 +347,13 @@ def set_live_migrations_dir(project_uuid: str, relative_dir: str) -> None:
     save_manifest(manifest)
 
 
+def set_repo_taste_path(project_uuid: str, relative_path: str) -> None:
+    manifest = load_manifest()
+    old = _get_project(manifest, project_uuid)
+    manifest[project_uuid] = replace(old, repo_taste_path=relative_path)
+    save_manifest(manifest)
+
+
 # ---------------------------------------------------------------------------
 # Taste
 # ---------------------------------------------------------------------------
@@ -349,6 +379,8 @@ def default_taste_text() -> str:
 
 
 def ensure_taste_file(path: Path) -> Path:
+    if path.exists() and not path.is_file():
+        raise ContinuousRefactorError(f"Taste path is not a file: {path}")
     if not path.exists():
         path.parent.mkdir(parents=True, exist_ok=True)
         path.write_text(_DEFAULT_TASTE, encoding="utf-8")
@@ -366,7 +398,7 @@ def _read_taste_text(path: Path) -> str:
 
 def load_taste(project: ResolvedProject | None) -> str:
     if project is not None:
-        project_taste = project.project_dir / "taste.md"
+        project_taste = resolve_project_taste_path(project)
         if project_taste.exists():
             return _read_taste_text(project_taste)