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

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

@@ -4,6 +4,11 @@ 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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: worktree-env
-Version: 0.3.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:
 
@@ -306,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.3.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:
 
@@ -279,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.3.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` 路径后，需要再次执行：
 
@@ -230,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.3.0 → worktree_env-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "worktree-env"
-version = "0.3.0"
+version = "0.3.1"
 description = "Per-worktree ports, secrets, and local environment setup for Git"
 readme = "README.md"
 requires-python = ">=3.9"

{worktree_env-0.3.0 → worktree_env-0.3.1}/src/worktree_env/__init__.py

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

{worktree_env-0.3.0 → worktree_env-0.3.1}/src/worktree_env/config.py

@@ -53,9 +53,9 @@ writes:
       PORT=${backend}
       CORS_ORIGIN=http://127.0.0.1:${frontend}
 
-# Optional post-checkout initializers. Commands are trusted local configuration
-# executed directly in the background. args are appended to command, and 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]
     args: [install]

{worktree_env-0.3.0 → 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.3.0 → worktree_env-0.3.1}/tests/test_config.py

@@ -32,7 +32,7 @@ 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

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

@@ -55,6 +55,30 @@ 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
 ):

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

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