worktree-env 0.2.0__tar.gz → 0.3.1__tar.gz

{worktree_env-0.2.0 → worktree_env-0.3.1}/.github/workflows/publish.yml

@@ -20,11 +20,5 @@ jobs:
       - uses: astral-sh/setup-uv@v6
       - name: Build worktree-env
         run: uv build
-      - name: Build git-worktree-env transition package
-        if: github.ref == 'refs/tags/v0.2.0'
-        run: uv build migration/git-worktree-env --out-dir migration/git-worktree-env/dist
       - name: Publish worktree-env
         run: uv publish dist/* --trusted-publishing always
-      - name: Publish git-worktree-env transition package
-        if: github.ref == 'refs/tags/v0.2.0'
-        run: uv publish migration/git-worktree-env/dist/* --trusted-publishing always

{worktree_env-0.2.0 → worktree_env-0.3.1}/CHANGELOG.md

@@ -4,12 +4,22 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.3.1] - 2026-08-21
+
+- Run profile initializers from the Monitor Reconciler so worktrees created by
+  sandboxed coding agents and IDEs receive the same setup as hook-created worktrees.
+
+## [0.3.0] - 2026-08-21
+
+- Changed profile initializers to `command` and `args` string arrays, executed
+  directly without an implicit shell.
+- Renamed the Python module from `git_worktree_env` to `worktree_env`.
+
 ## [0.2.0] - 2026-08-21
 
 - Renamed the PyPI package and GitHub repository from `git-worktree-env` to
   `worktree-env`.
-- Kept the `wte` command, `git_worktree_env` Python module, and existing
-  `~/.config/wte/` configuration compatible.
+- Kept the `wte` command and existing `~/.config/wte/` configuration compatible.
 - Added a final `git-worktree-env` transition package and runtime migration guidance.
 
 ## [0.1.4] - 2026-08-20

{worktree_env-0.2.0 → worktree_env-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: worktree-env
-Version: 0.2.0
+Version: 0.3.1
 Summary: Per-worktree ports, secrets, and local environment setup for Git
 Project-URL: Homepage, https://github.com/archcst/worktree-env
 Project-URL: Repository, https://github.com/archcst/worktree-env
@@ -262,8 +262,8 @@ minimal.
 The Reconciler:
 
 1. Runs `git worktree list --porcelain` to retrieve the actual list of worktrees.
-2. Compares it with `ports.json`, then assigns ports, mounts secrets, and generates
-   files for unregistered worktrees.
+2. Compares it with `ports.json`, then assigns ports, mounts secrets, generates
+   files, and starts configured initializers for unregistered worktrees.
 
 After adding a profile or changing a `main_worktree` path, run this command again:
 
@@ -286,11 +286,13 @@ environment to be initialized in the background:
 
 ```yaml
 init:
-  - command: npm install
+  - command: [npm]
+    args: [install]
     cwd: frontend-dir  # Use "." to run from the worktree root.
     skip_if: node_modules  # Skip this command if the file or directory exists.
 
-  - command: uv sync
+  - command: [uv]
+    args: [sync]
     cwd: backend-dir  # Use "." to run from the worktree root.
     skip_if: .venv  # Skip this command if the file or directory exists.
 ```
@@ -304,10 +306,10 @@ Create a worktree
   → By the time the user or AI starts the project, dependencies are usually ready
 ```
 
-Asynchronous initialization is started only by the normal `post-checkout` hook.
-Neither `wte sync` nor the Monitor Reconciler runs these commands, preventing manual
-synchronization or background reconciliation from repeatedly starting expensive
-tasks.
+Asynchronous initialization is started by the normal `post-checkout` hook or by the
+Monitor Reconciler when it discovers an unregistered worktree. The Reconciler does
+not process registered worktrees again, and each command's `skip_if` marker provides
+additional protection against repeated setup. `wte sync` does not run initializers.
 
 ## Commands supported by `wte`
 

{worktree_env-0.2.0 → worktree_env-0.3.1}/README.md

@@ -235,8 +235,8 @@ minimal.
 The Reconciler:
 
 1. Runs `git worktree list --porcelain` to retrieve the actual list of worktrees.
-2. Compares it with `ports.json`, then assigns ports, mounts secrets, and generates
-   files for unregistered worktrees.
+2. Compares it with `ports.json`, then assigns ports, mounts secrets, generates
+   files, and starts configured initializers for unregistered worktrees.
 
 After adding a profile or changing a `main_worktree` path, run this command again:
 
@@ -259,11 +259,13 @@ environment to be initialized in the background:
 
 ```yaml
 init:
-  - command: npm install
+  - command: [npm]
+    args: [install]
     cwd: frontend-dir  # Use "." to run from the worktree root.
     skip_if: node_modules  # Skip this command if the file or directory exists.
 
-  - command: uv sync
+  - command: [uv]
+    args: [sync]
     cwd: backend-dir  # Use "." to run from the worktree root.
     skip_if: .venv  # Skip this command if the file or directory exists.
 ```
@@ -277,10 +279,10 @@ Create a worktree
   → By the time the user or AI starts the project, dependencies are usually ready
 ```
 
-Asynchronous initialization is started only by the normal `post-checkout` hook.
-Neither `wte sync` nor the Monitor Reconciler runs these commands, preventing manual
-synchronization or background reconciliation from repeatedly starting expensive
-tasks.
+Asynchronous initialization is started by the normal `post-checkout` hook or by the
+Monitor Reconciler when it discovers an unregistered worktree. The Reconciler does
+not process registered worktrees again, and each command's `skip_if` marker provides
+additional protection against repeated setup. `wte sync` does not run initializers.
 
 ## Commands supported by `wte`
 

{worktree_env-0.2.0 → worktree_env-0.3.1}/README.zh-CN.md

@@ -188,7 +188,7 @@ wte monitor enable
 Reconciler 会：
 
 1. 执行 `git worktree list --porcelain` 获取真实 Worktree 列表。
-2. 与 `ports.json` 对比，为尚未注册的 Worktree 分配端口、挂载 Secrets、生成文件。
+2. 与 `ports.json` 对比，为尚未注册的 Worktree 分配端口、挂载 Secrets、生成文件并启动配置的初始化命令。
 
 新增 Profile 或修改 `main_worktree` 路径后，需要再次执行：
 
@@ -210,11 +210,13 @@ wte monitor disable
 
 ```yaml
 init:
-  - command: npm install
+  - command: [npm]
+    args: [install]
     cwd: frontend-dir # 若在 Worktree 根目录执行，则填写“.”
     skip_if: node_modules # 若该文件或目录存在，则跳过该命令
 
-  - command: uv sync
+  - command: [uv]
+    args: [sync]
     cwd: backend-dir # 若在 Worktree 根目录执行，则填写“.”
     skip_if: .venv # 若该文件或目录存在，则跳过该命令
 ```
@@ -228,7 +230,7 @@ init:
   → 用户或 AI 启动项目时，依赖通常已经准备完成
 ```
 
-异步初始化只由正常的 `post-checkout` Hook 启动。`wte sync` 和 Monitor Reconciler 都不会执行这些命令，避免手动同步或后台补偿重复启动耗时任务。
+异步初始化由正常的 `post-checkout` Hook 启动；当 Monitor Reconciler 发现尚未注册的 Worktree 时也会启动。Reconciler 不会重复处理已注册的 Worktree，同时每条命令的 `skip_if` 标记可进一步避免重复初始化。`wte sync` 不会执行初始化命令。
 
 ## `wte` 支持的命令
 

{worktree_env-0.2.0 → worktree_env-0.3.1}/examples/fullstack.yaml

@@ -11,6 +11,8 @@ ports:
 
 # Sources stay outside Git. Targets are symlinks inside every linked worktree.
 secrets:
+  - source: $HOME/.config/example-app/frontend.env
+    target: apps/frontend/.env
   - source: $HOME/.config/example-app/backend.env
     target: apps/backend/.env
 
@@ -26,8 +28,13 @@ writes:
       CORS_ORIGIN=http://127.0.0.1:${frontend}
 
 # Initializers run in the background only from the post-checkout hook.
-# Each command is trusted local configuration and is executed by Bash.
+# Each command is trusted local configuration and is executed directly.
 init:
-  - command: npm install
-    cwd: .
+  - command: [npm]
+    args: [install]
+    cwd: apps/frontend
     skip_if: node_modules
+  - command: [uv]
+    args: [sync]
+    cwd: apps/backend
+    skip_if: .venv

{worktree_env-0.2.0 → worktree_env-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "worktree-env"
-version = "0.2.0"
+version = "0.3.1"
 description = "Per-worktree ports, secrets, and local environment setup for Git"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -37,8 +37,8 @@ Repository = "https://github.com/archcst/worktree-env"
 Issues = "https://github.com/archcst/worktree-env/issues"
 
 [project.scripts]
-wte = "git_worktree_env.cli:main"
-worktree-env = "git_worktree_env.cli:main"
+wte = "worktree_env.cli:main"
+worktree-env = "worktree_env.cli:main"
 
 [dependency-groups]
 dev = [
@@ -46,7 +46,7 @@ dev = [
 ]
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/git_worktree_env"]
+packages = ["src/worktree_env"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

{worktree_env-0.2.0/src/git_worktree_env → worktree_env-0.3.1/src/worktree_env}/__init__.py

@@ -1,3 +1,3 @@
 """worktree-env public package."""
 
-__version__ = "0.2.0"
+__version__ = "0.3.1"

{worktree_env-0.2.0/src/git_worktree_env → worktree_env-0.3.1/src/worktree_env}/__main__.py

@@ -1,4 +1,4 @@
-"""Allow ``python -m git_worktree_env`` to behave like ``wte``."""
+"""Allow ``python -m worktree_env`` to behave like ``wte``."""
 
 from .cli import main
 

{worktree_env-0.2.0/src/git_worktree_env → worktree_env-0.3.1/src/worktree_env}/config.py

@@ -36,6 +36,8 @@ ports:
 # Optional local secret files. Sources stay outside Git; targets are replaced
 # with symlinks inside each matched worktree.
 secrets:
+  - source: $HOME/.config/example-app/frontend.env
+    target: apps/frontend/.env
   - source: $HOME/.config/example-app/backend.env
     target: apps/backend/.env
 
@@ -51,12 +53,18 @@ writes:
       PORT=${backend}
       CORS_ORIGIN=http://127.0.0.1:${frontend}
 
-# Optional post-checkout initializers. Commands are trusted local configuration
-# executed by Bash in the background. skip_if is resolved relative to cwd.
+# Optional worktree initializers started by post-checkout or the Monitor Reconciler.
+# Commands are trusted local configuration executed directly in the background.
+# args are appended to command, and skip_if is resolved relative to cwd.
 init:
-  - command: npm install
-    cwd: .
+  - command: [npm]
+    args: [install]
+    cwd: apps/frontend
     skip_if: node_modules
+  - command: [uv]
+    args: [sync]
+    cwd: apps/backend
+    skip_if: .venv
 """
 
 

{worktree_env-0.2.0/src/git_worktree_env → worktree_env-0.3.1/src/worktree_env}/profiles.py

@@ -210,6 +210,35 @@ def validate_profiles(paths: AppPaths) -> Tuple[List[str], List[str]]:
                 elif Path(str(target)).is_absolute() or ".." in Path(str(target)).parts:
                     errors.append(f"{label}: secrets[{index}].target must stay inside the worktree")
 
+        initializers = profile.get("init")
+        if initializers is None:
+            initializers = []
+        if not isinstance(initializers, list):
+            errors.append(f"{label}: init must be a list")
+        else:
+            for index, entry in enumerate(initializers):
+                if not isinstance(entry, dict):
+                    errors.append(f"{label}: init[{index}] must be a mapping")
+                    continue
+                command = entry.get("command")
+                if (
+                    not isinstance(command, list)
+                    or not command
+                    or not all(isinstance(value, str) for value in command)
+                    or not command[0].strip()
+                ):
+                    errors.append(
+                        f"{label}: init[{index}].command must be a non-empty string list"
+                    )
+                args = entry.get("args", [])
+                if not isinstance(args, list) or not all(
+                    isinstance(value, str) for value in args
+                ):
+                    errors.append(f"{label}: init[{index}].args must be a string list")
+                cwd = entry.get("cwd")
+                if not isinstance(cwd, str) or not cwd.strip():
+                    errors.append(f"{label}: init[{index}].cwd is required")
+
     if not profiles:
         warnings.append(f"no profiles found in {paths.profiles}")
     return errors, warnings

{worktree_env-0.2.0/src/git_worktree_env → worktree_env-0.3.1/src/worktree_env}/projector.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import os
+import shlex
 import subprocess
 import tempfile
 from dataclasses import dataclass
@@ -90,11 +91,26 @@ def _init_entries(profile: Profile) -> List[Dict[str, Any]]:
 def run_initializers(profile: Profile, root: Path) -> None:
     """Start missing dependency setup tasks without blocking Git checkout."""
     for index, item in enumerate(_init_entries(profile)):
-        command = str(item.get("command") or "").strip()
-        cwd_raw = str(item.get("cwd") or "").strip()
-        if not command or not cwd_raw:
-            log(f"initializer skipped; command and cwd are required: {item}")
+        command = item.get("command")
+        args = item.get("args", [])
+        cwd_raw = item.get("cwd")
+        if (
+            not isinstance(command, list)
+            or not command
+            or not all(isinstance(value, str) for value in command)
+            or not command[0].strip()
+        ):
+            log(f"initializer skipped; command must be a non-empty string list: {item}")
             continue
+        if not isinstance(args, list) or not all(
+            isinstance(value, str) for value in args
+        ):
+            log(f"initializer skipped; args must be a string list: {item}")
+            continue
+        if not isinstance(cwd_raw, str) or not cwd_raw.strip():
+            log(f"initializer skipped; cwd is required: {item}")
+            continue
+        argv = command + args
         cwd = expand_profile_path(cwd_raw, profile, root=root).resolve()
         if not cwd.is_dir():
             log(f"initializer skipped; directory does not exist: {cwd}")
@@ -108,7 +124,7 @@ def run_initializers(profile: Profile, root: Path) -> None:
         output = log_path.open("a")
         try:
             subprocess.Popen(
-                ["bash", "-lc", command],
+                argv,
                 cwd=str(cwd),
                 stdout=output,
                 stderr=subprocess.STDOUT,
@@ -116,7 +132,7 @@ def run_initializers(profile: Profile, root: Path) -> None:
             )
         finally:
             output.close()
-        log(f"initializer started: {command} -> {log_path}")
+        log(f"initializer started: {shlex.join(argv)} -> {log_path}")
 
 
 def apply_worktree(

{worktree_env-0.2.0/src/git_worktree_env → worktree_env-0.3.1/src/worktree_env}/reconciler.py

@@ -110,7 +110,10 @@ def reconcile_once(paths: AppPaths) -> ReconcileResult:
             # Git may publish common-dir metadata before checkout is complete.
             if worktree_root(candidate) != candidate:
                 raise WteError(f"worktree root is not stable yet: {candidate}")
-            result = apply_worktree(paths, candidate, setup=False)
+            # The reconciler is the fallback for sandboxed Git clients that
+            # cannot invoke the host's post-checkout hook, so it must perform
+            # the same asynchronous initialization for a new worktree.
+            result = apply_worktree(paths, candidate, setup=True)
             if result is None:
                 continue
             print_apply_result(result)

{worktree_env-0.2.0 → worktree_env-0.3.1}/tests/conftest.py

@@ -6,7 +6,7 @@ from typing import Sequence
 
 import pytest
 
-from git_worktree_env.paths import AppPaths
+from worktree_env.paths import AppPaths
 
 
 def run(command: Sequence[str], cwd: Path) -> str:

{worktree_env-0.2.0 → worktree_env-0.3.1}/tests/test_cli.py

@@ -2,7 +2,7 @@ import argparse
 
 import pytest
 
-from git_worktree_env.cli import _build_parser, _warn_if_legacy_distribution_installed
+from worktree_env.cli import _build_parser, _warn_if_legacy_distribution_installed
 
 
 def test_public_cli_contains_only_the_six_user_commands():
@@ -37,7 +37,7 @@ def test_sync_does_not_accept_a_worktree_path():
 
 def test_legacy_distribution_prints_migration_instructions(monkeypatch, capsys):
     monkeypatch.setattr(
-        "git_worktree_env.cli.metadata.distribution", lambda _name: object()
+        "worktree_env.cli.metadata.distribution", lambda _name: object()
     )
 
     _warn_if_legacy_distribution_installed()

{worktree_env-0.2.0 → worktree_env-0.3.1}/tests/test_config.py

@@ -1,12 +1,12 @@
 import pytest
 
-from git_worktree_env.config import (
+from worktree_env.config import (
     initialize_config,
     initialize_profile_template,
     load_port_pool,
 )
-from git_worktree_env.paths import AppPaths
-from git_worktree_env.utils import WteError
+from worktree_env.paths import AppPaths
+from worktree_env.utils import WteError
 
 
 def test_init_generates_documented_port_range(tmp_path, monkeypatch):
@@ -32,7 +32,11 @@ def test_init_template_is_commented_and_not_an_active_yaml_profile(app_paths):
     assert "# Port IDs form one contiguous block" in text
     assert "# Optional local secret files" in text
     assert "# Optional generated files" in text
-    assert "# Optional post-checkout initializers" in text
+    assert "# Optional worktree initializers" in text
+    assert "$HOME/.config/example-app/frontend.env" in text
+    assert "$HOME/.config/example-app/backend.env" in text
+    assert "cwd: apps/frontend" in text
+    assert "cwd: apps/backend" in text
     assert "wte monitor enable" in text
 
 

{worktree_env-0.2.0 → worktree_env-0.3.1}/tests/test_hooks.py

@@ -2,8 +2,8 @@ from pathlib import Path
 
 import pytest
 
-from git_worktree_env.hooks import _dispatcher_script, install_hooks
-from git_worktree_env.utils import WteError
+from worktree_env.hooks import _dispatcher_script, install_hooks
+from worktree_env.utils import WteError
 
 
 def test_dispatcher_runs_wte_only_for_post_checkout():
@@ -22,7 +22,7 @@ def test_install_refuses_to_replace_an_existing_global_hooks_path(
     existing = tmp_path / "other-hooks"
     existing.mkdir()
     monkeypatch.setattr(
-        "git_worktree_env.hooks.current_hooks_path", lambda: str(existing)
+        "worktree_env.hooks.current_hooks_path", lambda: str(existing)
     )
 
     with pytest.raises(WteError, match="wte did not change it"):

worktree_env-0.3.1/tests/test_profiles.py

@@ -0,0 +1,67 @@
+from pathlib import Path
+
+from worktree_env.profiles import find_profile, main_worktree_root, validate_profiles
+
+
+def test_linked_worktree_matches_its_main_profile(app_paths, git_worktrees):
+    main, linked = git_worktrees
+    (app_paths.profiles / "example.yaml").write_text(
+        "name: example\n"
+        "match:\n"
+        f"  main_worktree: {main}\n"
+        "ports:\n"
+        "  - id: web\n"
+    )
+
+    profile = find_profile(app_paths, linked)
+
+    assert profile is not None
+    assert profile["name"] == "example"
+    assert main_worktree_root(linked) == main
+
+
+def test_validation_rejects_duplicate_main_worktrees(app_paths, git_worktrees):
+    main, _ = git_worktrees
+    for name in ("one", "two"):
+        (app_paths.profiles / f"{name}.yaml").write_text(
+            f"name: {name}\n"
+            f"match:\n  main_worktree: {main}\n"
+            "ports:\n  - id: web\n"
+        )
+
+    errors, _warnings = validate_profiles(app_paths)
+
+    assert any("also configured" in error for error in errors)
+
+
+def test_validation_accepts_initializer_command_and_args_lists(app_paths, tmp_path):
+    (app_paths.profiles / "example.yaml").write_text(
+        "name: example\n"
+        f"match:\n  main_worktree: {tmp_path}\n"
+        "ports:\n  - id: web\n"
+        "init:\n"
+        "  - command: [npm]\n"
+        "    args: [install]\n"
+        "    cwd: .\n"
+    )
+
+    errors, _warnings = validate_profiles(app_paths)
+
+    assert not errors
+
+
+def test_validation_rejects_initializer_string_command(app_paths, tmp_path):
+    (app_paths.profiles / "example.yaml").write_text(
+        "name: example\n"
+        f"match:\n  main_worktree: {tmp_path}\n"
+        "ports:\n  - id: web\n"
+        "init:\n"
+        "  - command: npm install\n"
+        "    cwd: .\n"
+    )
+
+    errors, _warnings = validate_profiles(app_paths)
+
+    assert any(
+        "init[0].command must be a non-empty string list" in error for error in errors
+    )

{worktree_env-0.2.0 → worktree_env-0.3.1}/tests/test_projector.py

@@ -1,8 +1,8 @@
 import pytest
 
-from git_worktree_env.projector import apply_worktree
-from git_worktree_env.registry import load_registry
-from git_worktree_env.utils import WteError
+from worktree_env.projector import apply_worktree, run_initializers
+from worktree_env.registry import load_registry
+from worktree_env.utils import WteError
 
 
 def test_projection_links_secrets_and_writes_ports(app_paths, git_worktrees, tmp_path, monkeypatch):
@@ -25,7 +25,7 @@ def test_projection_links_secrets_and_writes_ports(app_paths, git_worktrees, tmp
     generated_path = linked / "app/.env.development"
     generated_path.parent.mkdir(parents=True)
     generated_path.write_text("KEEP=old\n")
-    monkeypatch.setattr("git_worktree_env.registry.port_is_free", lambda _port: True)
+    monkeypatch.setattr("worktree_env.registry.port_is_free", lambda _port: True)
 
     result = apply_worktree(app_paths, linked)
 
@@ -39,6 +39,35 @@ def test_projection_links_secrets_and_writes_ports(app_paths, git_worktrees, tmp
     assert load_registry(app_paths)[str(linked)]["profile"] == "example"
 
 
+def test_initializers_execute_command_and_args_without_a_shell(
+    tmp_path, monkeypatch, capsys
+):
+    calls = []
+    profile = {
+        "name": "example",
+        "init": [
+            {
+                "command": ["tool", "subcommand"],
+                "args": ["literal;value", "two words"],
+                "cwd": ".",
+            }
+        ],
+    }
+    monkeypatch.setattr(
+        "worktree_env.projector.tempfile.gettempdir", lambda: str(tmp_path)
+    )
+    monkeypatch.setattr(
+        "worktree_env.projector.subprocess.Popen",
+        lambda argv, **kwargs: calls.append((argv, kwargs)),
+    )
+
+    run_initializers(profile, tmp_path)
+
+    assert calls[0][0] == ["tool", "subcommand", "literal;value", "two words"]
+    assert calls[0][1]["cwd"] == str(tmp_path.resolve())
+    assert "tool subcommand 'literal;value' 'two words'" in capsys.readouterr().err
+
+
 def test_failed_projection_does_not_commit_a_registry_entry(
     app_paths, git_worktrees, monkeypatch
 ):
@@ -49,12 +78,12 @@ def test_failed_projection_does_not_commit_a_registry_entry(
         "ports:\n  - id: web\n"
         "writes:\n  - path: generated.env\n    body: PORT=${web}\n"
     )
-    monkeypatch.setattr("git_worktree_env.registry.port_is_free", lambda _port: True)
+    monkeypatch.setattr("worktree_env.registry.port_is_free", lambda _port: True)
 
     def fail_writes(*_args):
         raise WteError("write failed")
 
-    monkeypatch.setattr("git_worktree_env.projector.apply_writes", fail_writes)
+    monkeypatch.setattr("worktree_env.projector.apply_writes", fail_writes)
 
     with pytest.raises(WteError, match="write failed"):
         apply_worktree(app_paths, linked)

{worktree_env-0.2.0 → worktree_env-0.3.1}/tests/test_reconciler.py

@@ -1,7 +1,7 @@
 import plistlib
 from pathlib import Path
 
-from git_worktree_env.reconciler import (
+from worktree_env.reconciler import (
     LAUNCHD_LABEL,
     _listed_worktrees,
     _write_launch_agent,
@@ -9,7 +9,7 @@ from git_worktree_env.reconciler import (
     discover_watch_paths,
     reconcile_once,
 )
-from git_worktree_env.registry import load_registry
+from worktree_env.registry import load_registry
 
 
 def test_git_porcelain_discovery_returns_main_and_linked_worktrees(git_worktrees):
@@ -41,7 +41,7 @@ def test_reconciler_projects_only_unregistered_worktrees(
         "ports:\n  - id: web\n"
         "writes:\n  - path: generated.env\n    body: PORT=${web}\n"
     )
-    monkeypatch.setattr("git_worktree_env.registry.port_is_free", lambda _port: True)
+    monkeypatch.setattr("worktree_env.registry.port_is_free", lambda _port: True)
 
     first = reconcile_once(app_paths)
     second = reconcile_once(app_paths)
@@ -55,13 +55,37 @@ def test_reconciler_projects_only_unregistered_worktrees(
     assert (linked / "generated.env").exists()
 
 
+def test_reconciler_runs_initializers_for_unregistered_worktrees(
+    app_paths, git_worktrees, monkeypatch
+):
+    main, linked = git_worktrees
+    (app_paths.profiles / "example.yaml").write_text(
+        "name: example\n"
+        f"match:\n  main_worktree: {main}\n"
+        "ports:\n  - id: web\n"
+        "init:\n  - command: [tool]\n    cwd: .\n"
+    )
+    monkeypatch.setattr("worktree_env.registry.port_is_free", lambda _port: True)
+    initialized = []
+    monkeypatch.setattr(
+        "worktree_env.projector.run_initializers",
+        lambda _profile, root: initialized.append(root),
+    )
+
+    reconcile_once(app_paths)
+    reconcile_once(app_paths)
+
+    assert set(initialized) == {main.resolve(), linked.resolve()}
+    assert len(initialized) == 2
+
+
 def test_launch_agent_watches_common_git_metadata(
     app_paths, tmp_path, monkeypatch
 ):
     agent = tmp_path / "wte.plist"
     watched = (tmp_path / "repo/.git/worktrees",)
     monkeypatch.setattr(
-        "git_worktree_env.reconciler._launch_agent_path", lambda: agent
+        "worktree_env.reconciler._launch_agent_path", lambda: agent
     )
 
     _write_launch_agent(app_paths, Path("/opt/bin/wte"), watched)
@@ -77,7 +101,7 @@ def test_systemd_path_unit_uses_one_shot_reconciliation(tmp_path, monkeypatch):
     unit_dir = tmp_path / "systemd/user"
     watched = (tmp_path / "repo/.git/worktrees",)
     monkeypatch.setattr(
-        "git_worktree_env.reconciler._systemd_user_dir", lambda: unit_dir
+        "worktree_env.reconciler._systemd_user_dir", lambda: unit_dir
     )
 
     service, path_unit = _write_systemd_units(Path("/opt/bin/wte"), watched)

{worktree_env-0.2.0 → worktree_env-0.3.1}/tests/test_registry.py

@@ -3,14 +3,14 @@ from pathlib import Path
 
 import pytest
 
-from git_worktree_env.config import PortPool
-from git_worktree_env.registry import (
+from worktree_env.config import PortPool
+from worktree_env.registry import (
     allocate_ports,
     load_registry,
     prune_registry,
     save_registry,
 )
-from git_worktree_env.utils import WteError
+from worktree_env.utils import WteError
 
 
 def test_allocation_is_sticky_and_contiguous(app_paths, tmp_path, monkeypatch):
@@ -21,7 +21,7 @@ def test_allocation_is_sticky_and_contiguous(app_paths, tmp_path, monkeypatch):
         "_file": str(tmp_path / "example.yaml"),
         "ports": [{"id": "frontend"}, {"id": "backend"}],
     }
-    monkeypatch.setattr("git_worktree_env.registry.port_is_free", lambda _port: True)
+    monkeypatch.setattr("worktree_env.registry.port_is_free", lambda _port: True)
 
     start, ports = allocate_ports(profile, root, {}, PortPool(42000, 42010))
     registry = {

{worktree_env-0.2.0 → worktree_env-0.3.1}/uv.lock

@@ -258,7 +258,7 @@ wheels = [
 
 [[package]]
 name = "worktree-env"
-version = "0.2.0"
+version = "0.3.1"
 source = { editable = "." }
 dependencies = [
     { name = "pyyaml" },

worktree_env-0.2.0/migration/git-worktree-env/README.md

@@ -1,43 +0,0 @@
-# `git-worktree-env` has moved
-
-> **This package has been renamed to [`worktree-env`](https://pypi.org/project/worktree-env/).**
-
-This is the final transition release of `git-worktree-env`. It installs the renamed
-package so existing users can continue to run `wte`, but future releases will only be
-published as `worktree-env`.
-
-## Migrate an existing installation
-
-For an installation managed by `uv`:
-
-```bash
-uv tool uninstall git-worktree-env
-uv tool install worktree-env
-wte init
-# If you previously enabled the optional Monitor:
-wte monitor enable
-```
-
-For an installation managed by `pipx`:
-
-```bash
-pipx uninstall git-worktree-env
-pipx install worktree-env
-wte init
-# If you previously enabled the optional Monitor:
-wte monitor enable
-```
-
-For an installation managed by `pip`:
-
-```bash
-python -m pip uninstall -y git-worktree-env
-python -m pip install --upgrade --force-reinstall worktree-env
-wte init
-# If you previously enabled the optional Monitor:
-wte monitor enable
-```
-
-Running `wte init` refreshes the Git hook's absolute executable path. The `wte`
-command, the `git_worktree_env` Python import, and all existing configuration under
-`~/.config/wte/` remain compatible.

worktree_env-0.2.0/migration/git-worktree-env/pyproject.toml

@@ -1,37 +0,0 @@
-[build-system]
-requires = ["hatchling>=1.26"]
-build-backend = "hatchling.build"
-
-[project]
-name = "git-worktree-env"
-version = "0.2.0"
-description = "Transition package for the renamed worktree-env project"
-readme = "README.md"
-requires-python = ">=3.9"
-license = "MIT"
-authors = [
-  { name = "Shitong Chen" },
-]
-classifiers = [
-  "Development Status :: 7 - Inactive",
-  "Environment :: Console",
-  "License :: OSI Approved :: MIT License",
-  "Operating System :: MacOS",
-  "Operating System :: POSIX :: Linux",
-  "Programming Language :: Python :: 3",
-]
-dependencies = [
-  "worktree-env>=0.2.0",
-]
-
-[project.urls]
-Homepage = "https://github.com/archcst/worktree-env"
-Repository = "https://github.com/archcst/worktree-env"
-Issues = "https://github.com/archcst/worktree-env/issues"
-
-[project.scripts]
-wte = "git_worktree_env_compat:main"
-git-worktree-env = "git_worktree_env_compat:main"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/git_worktree_env_compat"]

worktree_env-0.2.0/migration/git-worktree-env/src/git_worktree_env_compat/__init__.py

@@ -1,8 +0,0 @@
-"""Console-script bridge from git-worktree-env to worktree-env."""
-
-
-def main() -> int:
-    """Delegate to the CLI supplied by the renamed distribution."""
-    from git_worktree_env.cli import main as worktree_env_main
-
-    return worktree_env_main()

worktree_env-0.2.0/tests/test_profiles.py

@@ -1,34 +0,0 @@
-from pathlib import Path
-
-from git_worktree_env.profiles import find_profile, main_worktree_root, validate_profiles
-
-
-def test_linked_worktree_matches_its_main_profile(app_paths, git_worktrees):
-    main, linked = git_worktrees
-    (app_paths.profiles / "example.yaml").write_text(
-        "name: example\n"
-        "match:\n"
-        f"  main_worktree: {main}\n"
-        "ports:\n"
-        "  - id: web\n"
-    )
-
-    profile = find_profile(app_paths, linked)
-
-    assert profile is not None
-    assert profile["name"] == "example"
-    assert main_worktree_root(linked) == main
-
-
-def test_validation_rejects_duplicate_main_worktrees(app_paths, git_worktrees):
-    main, _ = git_worktrees
-    for name in ("one", "two"):
-        (app_paths.profiles / f"{name}.yaml").write_text(
-            f"name: {name}\n"
-            f"match:\n  main_worktree: {main}\n"
-            "ports:\n  - id: web\n"
-        )
-
-    errors, _warnings = validate_profiles(app_paths)
-
-    assert any("also configured" in error for error in errors)