Drop the pre-release .httk-project anchor detection arm

Author: rartino

docs/projects.md

@@ -284,19 +284,6 @@ Run the shown `httk project import-v1 /path/to/project`. It reads
 `/path/to/project/ht.project/config`, copies the public keys, pins the readable
 legacy keys as trusted, and creates `/path/to/project/httk_project/`.
 
-A pre-release v2 project containing `.httk-project/project.json` produces:
-
-```console
-$ httk project show
-httk project: found a project anchor from a pre-release httk v2 ('.httk-project') at /path/to/project; rename it: mv /path/to/project/.httk-project /path/to/project/httk_project
-```
-
-Apply the shown remedy from the project root:
-
-```console
-mv .httk-project httk_project
-```
-
 ## Identity keys, pinning, and trust
 
 A project owns one Ed25519 signing key. Its public half is recorded in

src/httk/core/project/anchor.py

@@ -44,41 +44,29 @@
 
 
 class LegacyProjectError(ValueError):
-    """Raised when discovery finds a legacy project directory.
+    """Raised when discovery finds an httk v1 ``ht.project`` directory.
 
-    Carries the offending directory as :attr:`root` and the legacy flavor as
-    :attr:`kind` — ``"v1"`` for an httk v1 ``ht.project`` directory,
-    ``"prerelease"`` for a pre-release httk v2 ``.httk-project`` anchor — so a
-    caller that deliberately handles one flavor (for example read-only
-    verification of a v1 manifest) does not have to parse the message.
+    Carries the offending directory as :attr:`root` so a caller that
+    deliberately handles it (for example read-only verification of a v1
+    manifest) does not have to parse the message.
 
     :param message: Diagnostic explaining the legacy project and its remedy.
     :param root: Directory containing the legacy project marker.
-    :param kind: Legacy flavor, either v1 or prerelease.
     """
 
-    def __init__(self, message: str, *, root: Path, kind: str) -> None:
+    def __init__(self, message: str, *, root: Path) -> None:
         super().__init__(message)
         self.root = root
-        self.kind = kind
 
 
-def _legacy_project_error(candidate: Path, *, allow_v1: bool = False) -> LegacyProjectError | None:
+def _legacy_project_error(candidate: Path) -> LegacyProjectError | None:
     if (candidate / PROJECT_DIRECTORY / PROJECT_FILE).is_file():
         return None
-    if not allow_v1 and (candidate / "ht.project").is_dir():
+    if (candidate / "ht.project").is_dir():
         return LegacyProjectError(
             f"found an httk v1 project ('ht.project') at {candidate}; "
             f"create the httk v2 anchor with: httk project import-v1 {candidate}",
             root=candidate,
-            kind="v1",
-        )
-    if (candidate / ".httk-project" / PROJECT_FILE).is_file():
-        return LegacyProjectError(
-            f"found a project anchor from a pre-release httk v2 ('.httk-project') at {candidate}; "
-            f"rename it: mv {candidate}/.httk-project {candidate}/{PROJECT_DIRECTORY}",
-            root=candidate,
-            kind="prerelease",
         )
     return None
 
@@ -87,13 +75,12 @@ def discover_project(start: str | os.PathLike[str] | None = None) -> Path | None
     """Find the nearest project root, or refuse a legacy one, at or above *start*.
 
     Discovery walks from start and its parents, treating a file start as its
-    containing directory. If it finds a legacy marker, the exception identifies
-    the required remedy: run httk project import-v1 PATH for ht.project, or
-    rename .httk-project to httk_project for the pre-release anchor.
+    containing directory. If it finds a legacy ht.project marker, the exception
+    identifies the required remedy: run httk project import-v1 PATH.
 
     :param start: Directory or file from which to begin the upward search, or None for the current directory.
     :return: Nearest project root, or None when no marker is found.
-    :raises httk.core.project.LegacyProjectError: If discovery finds a v1 or pre-release project marker.
+    :raises httk.core.project.LegacyProjectError: If discovery finds a v1 project marker.
     """
 
     path = Path.cwd() if start is None else Path(start)
@@ -114,7 +101,7 @@ def require_project(start: str | os.PathLike[str] | None = None) -> Path:
 
     :param start: Directory or file from which to begin the upward search, or None for the current directory.
     :return: Nearest project root.
-    :raises httk.core.project.LegacyProjectError: If discovery finds a v1 or pre-release project marker.
+    :raises httk.core.project.LegacyProjectError: If discovery finds a v1 project marker.
     :raises ValueError: If no project marker is found.
     """
 
@@ -393,7 +380,7 @@ def initialize_project(
     :param description: Optional project description.
     :param manifest_exclusions: Relative paths excluded from project manifests.
     :return: Newly written project metadata.
-    :raises httk.core.project.LegacyProjectError: If root contains a v1 or pre-release project marker.
+    :raises httk.core.project.LegacyProjectError: If root contains a v1 project marker.
     """
 
     project = Path(root).expanduser().resolve()
@@ -454,7 +441,6 @@ def import_v1_project(
     :param name: Optional replacement project name.
     :return: Imported project metadata.
     :raises FileNotFoundError: If the legacy project directory does not exist.
-    :raises httk.core.project.LegacyProjectError: If root contains an incompatible project anchor.
     """
 
     project = Path(root).expanduser().resolve()
@@ -465,12 +451,8 @@ def import_v1_project(
     parser.read(legacy / "config", encoding="utf-8")
     project_name = name if name is not None else str(parser.get("main", "project_name", fallback=project.name))
     # Importing v1 intentionally creates the v2 anchor beside its ht.project
-    # directory, so the v1 flavor of the legacy check is waived here — and only
-    # here, through the private unchecked initializer. A pre-release
-    # .httk-project anchor is still refused with its rename remedy.
-    error = _legacy_project_error(project, allow_v1=True)
-    if error is not None:
-        raise error
+    # directory through the private unchecked initializer, so no legacy refusal
+    # applies here.
     metadata = _initialize_project_unchecked(project, name=project_name)
     metadata["imported_from"] = str(legacy)
     public_keys: list[str] = []

tests/test_project.py

@@ -81,13 +81,6 @@ def test_initialize_refuses_legacy_project_directories(tmp_path: Path) -> None:
         initialize_project(v1, name="v1")
     assert not (v1 / PROJECT_DIRECTORY).exists()
 
-    prerelease = tmp_path / "prerelease"
-    (prerelease / ".httk-project").mkdir(parents=True)
-    (prerelease / ".httk-project" / PROJECT_FILE).write_text("{}", encoding="utf-8")
-    with pytest.raises(LegacyProjectError, match="rename it: mv"):
-        initialize_project(prerelease, name="prerelease")
-    assert not (prerelease / PROJECT_DIRECTORY).exists()
-
 
 def test_discover_walks_upward_and_require_refuses_when_absent(tmp_path: Path) -> None:
     project = tmp_path / "root"
@@ -183,16 +176,6 @@ def test_import_v1_creates_the_anchor_and_adopts_legacy_keys(tmp_path: Path) ->
     assert (project / PROJECT_DIRECTORY / "keys" / "legacy-public" / "old.pub").is_file()
 
 
-def test_discover_refuses_a_pre_release_v2_anchor(tmp_path: Path) -> None:
-    anchor = tmp_path / ".httk-project"
-    anchor.mkdir()
-    (anchor / PROJECT_FILE).write_text("{}", encoding="utf-8")
-
-    with pytest.raises(LegacyProjectError, match="rename it: mv") as error:
-        discover_project(tmp_path)
-    assert f"mv {tmp_path}/.httk-project {tmp_path}/httk_project" in str(error.value)
-
-
 # ---------------------------------------------------------------------------
 # The umbrella command line
 # ---------------------------------------------------------------------------
@@ -254,20 +237,11 @@ def test_bare_project_command_prints_help(tmp_path) -> None:
     assert command([], context) == 0
 
 
-def test_legacy_error_carries_root_and_kind(tmp_path: Path) -> None:
+def test_legacy_error_carries_root(tmp_path: Path) -> None:
     (tmp_path / "ht.project").mkdir()
     with pytest.raises(LegacyProjectError) as error:
         discover_project(tmp_path)
     assert error.value.root == tmp_path
-    assert error.value.kind == "v1"
-
-    prerelease = tmp_path / "elsewhere"
-    (prerelease / ".httk-project").mkdir(parents=True)
-    (prerelease / ".httk-project" / PROJECT_FILE).write_text("{}", encoding="utf-8")
-    with pytest.raises(LegacyProjectError) as error:
-        discover_project(prerelease)
-    assert error.value.root == prerelease
-    assert error.value.kind == "prerelease"
 
 
 def test_initialize_project_has_no_legacy_bypass_parameter() -> None: