worktree-runtime 0.1.0a1__cp313-cp313-win_amd64.whl

_worktree_runtime_rust/__init__.py

@@ -0,0 +1,5 @@
+from ._worktree_runtime_rust import *
+
+__doc__ = _worktree_runtime_rust.__doc__
+if hasattr(_worktree_runtime_rust, "__all__"):
+    __all__ = _worktree_runtime_rust.__all__

worktree_runtime/AGENTS.md

@@ -0,0 +1,14 @@
+# src/worktree_runtime
+
+This tree is the Python facade.
+
+Allowed in this tree:
+
+- `api` re-export
+- `.pyi` stubs
+- `SURFACE.yaml`
+- `presentation/audit_cli.py`
+
+Do not implement behavior in new Python modules. Do not add files beyond this facade.
+
+If the public surface changes, update `SURFACE.yaml` and `.pyi` in the same change.

worktree_runtime/SURFACE.yaml

@@ -0,0 +1,224 @@
+version: 2
+description: worktree_runtime public API surface manifest
+enforced: true
+modules:
+  root:
+    import_path: worktree_runtime.api
+    source_file: src/worktree_runtime/api/__init__.py
+    symbols:
+    - name: ADAPTIVE_TASK_SHARED_DIR_ENV
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: issue-1982
+    - name: GitHubPolicy
+      source: _worktree_runtime_rust
+      kind: class
+      added_in_wave: rust-primary
+    - name: GitWorktree
+      source: _worktree_runtime_rust
+      kind: class
+      added_in_wave: git-domain-vocabulary
+    - name: ProjectIdInvalidError
+      source: _worktree_runtime_rust
+      kind: class
+      added_in_wave: rust-primary
+    - name: BindingValidationOptions
+      source: _worktree_runtime_rust
+      kind: class
+      added_in_wave: 1
+    - name: BindingValidationResult
+      source: _worktree_runtime_rust
+      kind: class
+      added_in_wave: 1
+    - name: CURRENT_SCHEMA_VERSION
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: 1
+    - name: LEGACY_PROJECT_ID
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: 1
+    - name: MAIN_BRANCHES
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: 1
+    - name: NOVELER_BRANCH_ENV
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: 1
+    - name: NOVELER_PROJECT_ROOT_ENV
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: 1
+    - name: NOVELER_REPO_ROOT_ENV
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: 1
+    - name: NOVELER_SHARED_DIR_ENV
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: 1
+    - name: NOVELER_STATE_DIR_ENV
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: 1
+    - name: NOVELER_WORKTREE_BASE_ENV
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: 1
+    - name: NOVELER_WORKTREE_ENV
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: 1
+    - name: UV_PROJECT_ENV
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: 1
+    - name: WORKTREE_IDENTITY_ENV_VARS
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: 1
+    - name: WORKTREE_LOCATION_ENV_VARS
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: 1
+    - name: WORKTREE_PROJECT_ENV_VARS
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: 1
+    - name: WORKTREE_RUNTIME_ENV_VARS
+      source: _worktree_runtime_rust
+      kind: constant
+      added_in_wave: 1
+    - name: WorktreeBinding
+      source: _worktree_runtime_rust
+      kind: class
+      added_in_wave: 1
+    - name: WorktreeBindingStore
+      source: _worktree_runtime_rust
+      kind: class
+      added_in_wave: 1
+    - name: WorktreeListEntry
+      source: _worktree_runtime_rust
+      kind: class
+      added_in_wave: issue-2231
+    - name: WorktreeListError
+      source: _worktree_runtime_rust
+      kind: class
+      added_in_wave: issue-2231
+    - name: WorktreePreconditionResult
+      source: _worktree_runtime_rust
+      kind: class
+      added_in_wave: 1
+    - name: is_main_worktree
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: git-domain-vocabulary
+    - name: list_worktrees
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: issue-2231
+    - name: list_bindings
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: binding-forget
+    - name: load_binding
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: normalize_path
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: path_fingerprint
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: git-domain-vocabulary
+    - name: read_records
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: reap_rotation_sentinel
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: record_event
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: recover_binding
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: remove_binding
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: binding-forget
+    - name: register_binding
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: resolve_git_worktree
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: git-domain-vocabulary
+    - name: resolve_github_policy
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: rust-primary
+    - name: resolve_main_branches
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: rust-primary
+    - name: resolve_known_worktree_bases
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: resolve_project_id
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: resolve_state_dir_name
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: resolve_worktree_base
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: resolve_worktree_dir
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: set_noveler_project_root_for_worktree
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: state_dir
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: store_relative_path
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: validate_binding
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: validate_current_binding
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: git-domain-vocabulary
+    - name: validate_main_worktree
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: git-domain-vocabulary
+    - name: worktree_identity_env_vars
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1
+    - name: worktree_runtime_env_vars
+      source: _worktree_runtime_rust
+      kind: function
+      added_in_wave: 1

worktree_runtime/__init__.py

@@ -0,0 +1 @@
+"""Worktree runtime package (Rust-primary)."""

worktree_runtime/api/__init__.py

@@ -0,0 +1,148 @@
+"""Public worktree path and binding API.
+
+Rust is the implementation SSOT. This module re-exports the PyO3 extension
+``_worktree_runtime_rust``. A missing native module is a hard install error.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path as _Path
+
+from _worktree_runtime_rust import (  # type: ignore[import-not-found]
+    ADAPTIVE_TASK_SHARED_DIR_ENV,
+    CURRENT_SCHEMA_VERSION,
+    GitHubPolicy,
+    GitWorktree,
+    LEGACY_PROJECT_ID,
+    MAIN_BRANCHES,
+    NOVELER_BRANCH_ENV,
+    NOVELER_PROJECT_ROOT_ENV,
+    NOVELER_REPO_ROOT_ENV,
+    NOVELER_SHARED_DIR_ENV,
+    NOVELER_STATE_DIR_ENV,
+    NOVELER_WORKTREE_BASE_ENV,
+    NOVELER_WORKTREE_ENV,
+    UV_PROJECT_ENV,
+    WORKTREE_IDENTITY_ENV_VARS,
+    WORKTREE_LOCATION_ENV_VARS,
+    WORKTREE_PROJECT_ENV_VARS,
+    WORKTREE_RUNTIME_ENV_VARS,
+    WorktreeListEntry,
+    WorktreeListError,
+    is_main_worktree,
+    list_bindings,
+    list_worktrees,
+    load_binding,
+    normalize_path,
+    path_fingerprint,
+    read_records,
+    reap_rotation_sentinel,
+    record_event,
+    recover_binding,
+    register_binding,
+    remove_binding,
+    resolve_git_worktree,
+    resolve_github_policy,
+    resolve_known_worktree_bases,
+    resolve_main_branches,
+    resolve_project_id,
+    resolve_state_dir_name,
+    resolve_worktree_base,
+    resolve_worktree_dir,
+    set_noveler_project_root_for_worktree,
+    state_dir,
+    store_relative_path,
+    validate_binding,
+    validate_current_binding,
+    validate_main_worktree,
+    worktree_identity_env_vars_py as worktree_identity_env_vars,
+    worktree_runtime_env_vars_py as worktree_runtime_env_vars,
+)
+from _worktree_runtime_rust import (  # type: ignore[import-not-found]
+    ProjectIdInvalidError,
+    PyBindingValidationOptions as BindingValidationOptions,
+    PyBindingValidationResult as BindingValidationResult,
+    PyWorktreeBinding as WorktreeBinding,
+    PyWorktreeBindingStore as WorktreeBindingStore,
+    PyWorktreePreconditionResult as WorktreePreconditionResult,
+)
+
+RUNTIME_IMPL = "rust"
+
+_native_list_worktrees = list_worktrees
+_native_list_bindings = list_bindings
+_native_store_relative_path = store_relative_path
+
+
+def _list_worktrees_as_tuple(repo_root, *, run=None):
+    return tuple(_native_list_worktrees(repo_root, run=run))
+
+
+def _list_bindings_as_tuple(repo_root):
+    return tuple(_native_list_bindings(repo_root))
+
+
+def _store_relative_path_as_path(project_id=None):
+    return _Path(_native_store_relative_path(project_id))
+
+
+list_worktrees = _list_worktrees_as_tuple
+list_bindings = _list_bindings_as_tuple
+store_relative_path = _store_relative_path_as_path
+
+__all__ = [
+    "ADAPTIVE_TASK_SHARED_DIR_ENV",
+    "CURRENT_SCHEMA_VERSION",
+    "GitHubPolicy",
+    "GitWorktree",
+    "LEGACY_PROJECT_ID",
+    "MAIN_BRANCHES",
+    "BindingValidationOptions",
+    "BindingValidationResult",
+    "NOVELER_BRANCH_ENV",
+    "NOVELER_PROJECT_ROOT_ENV",
+    "NOVELER_REPO_ROOT_ENV",
+    "NOVELER_SHARED_DIR_ENV",
+    "NOVELER_STATE_DIR_ENV",
+    "NOVELER_WORKTREE_BASE_ENV",
+    "NOVELER_WORKTREE_ENV",
+    "ProjectIdInvalidError",
+    "WorktreeBinding",
+    "WorktreeBindingStore",
+    "WorktreeListEntry",
+    "WorktreeListError",
+    "WorktreePreconditionResult",
+    "UV_PROJECT_ENV",
+    "WORKTREE_IDENTITY_ENV_VARS",
+    "WORKTREE_LOCATION_ENV_VARS",
+    "WORKTREE_PROJECT_ENV_VARS",
+    "WORKTREE_RUNTIME_ENV_VARS",
+    "is_main_worktree",
+    "list_bindings",
+    "list_worktrees",
+    "load_binding",
+    "normalize_path",
+    "path_fingerprint",
+    "recover_binding",
+    "read_records",
+    "reap_rotation_sentinel",
+    "record_event",
+    "register_binding",
+    "remove_binding",
+    "resolve_git_worktree",
+    "resolve_github_policy",
+    "resolve_known_worktree_bases",
+    "resolve_main_branches",
+    "resolve_project_id",
+    "resolve_state_dir_name",
+    "resolve_worktree_base",
+    "resolve_worktree_dir",
+    "set_noveler_project_root_for_worktree",
+    "state_dir",
+    "store_relative_path",
+    "validate_binding",
+    "validate_current_binding",
+    "validate_main_worktree",
+    "worktree_identity_env_vars",
+    "worktree_runtime_env_vars",
+]

worktree_runtime/api/__init__.pyi

@@ -0,0 +1,144 @@
+"""Typing stubs for worktree_runtime.api (Rust-primary public surface)."""
+
+from __future__ import annotations
+
+from collections.abc import Callable, Mapping, Sequence
+from datetime import datetime
+from pathlib import Path
+from typing import Any, Final
+
+CURRENT_SCHEMA_VERSION: Final[int]
+LEGACY_PROJECT_ID: Final[str]
+MAIN_BRANCHES: Final[frozenset[str]]
+ADAPTIVE_TASK_SHARED_DIR_ENV: Final[str]
+NOVELER_BRANCH_ENV: Final[str]
+NOVELER_PROJECT_ROOT_ENV: Final[str]
+NOVELER_REPO_ROOT_ENV: Final[str]
+NOVELER_SHARED_DIR_ENV: Final[str]
+NOVELER_STATE_DIR_ENV: Final[str]
+NOVELER_WORKTREE_BASE_ENV: Final[str]
+NOVELER_WORKTREE_ENV: Final[str]
+UV_PROJECT_ENV: Final[str]
+WORKTREE_IDENTITY_ENV_VARS: Final[tuple[str, ...]]
+WORKTREE_LOCATION_ENV_VARS: Final[tuple[str, ...]]
+WORKTREE_PROJECT_ENV_VARS: Final[tuple[str, ...]]
+WORKTREE_RUNTIME_ENV_VARS: Final[tuple[str, ...]]
+RUNTIME_IMPL: str
+
+class ProjectIdInvalidError(ValueError):
+    reason_code: str
+
+class WorktreeListError(Exception): ...
+
+class GitHubPolicy:
+    pr_title_prefixes: tuple[str, ...]
+    main_branches: frozenset[str]
+    pr_title_issue_suffix_required: bool
+    required_sections_issue: tuple[str, ...]
+    required_sections_pr: tuple[str, ...]
+
+class GitWorktree:
+    git_dir: str
+    git_common_dir: str
+    toplevel: str
+    branch: str
+    def is_main_worktree(self) -> bool: ...
+    def is_main_branch(self) -> bool: ...
+
+class WorktreeListEntry:
+    worktree: Path
+    branch: str | None
+    head: str
+    bare: bool
+    detached: bool
+    locked: bool
+    lock_reason: str | None
+    prunable: bool
+
+class BindingValidationOptions: ...
+class BindingValidationResult: ...
+class WorktreeBinding:
+    session_id: str
+    worktree: str
+    branch: str
+    state_path: str
+    git_common_dir: str
+    main_worktree: str
+    commit_ish: str
+    schema_version: int
+    def to_dict(self) -> dict[str, Any]: ...
+class WorktreeBindingStore: ...
+class WorktreePreconditionResult: ...
+
+def path_fingerprint(input_path: str) -> str: ...
+def is_main_worktree(context: GitWorktree) -> bool: ...
+def list_worktrees(
+    repo_root: Path,
+    *,
+    run: Callable[[Sequence[str], Path], Any] | None = None,
+) -> tuple[WorktreeListEntry, ...]: ...
+def list_bindings(repo_root: str) -> tuple[WorktreeBinding, ...]: ...
+def load_binding(session_id: str, repo_root: str) -> WorktreeBinding | None: ...
+def normalize_path(raw_path: str = "") -> str: ...
+def recover_binding(session_id: str, repo_root: str) -> WorktreeBinding | None: ...
+def remove_binding(session_id: str, repo_root: str) -> WorktreeBinding | None: ...
+def read_records(
+    branch: str | None = None,
+    worktree_path: str | None = None,
+    since: datetime | None = None,
+    until: datetime | None = None,
+) -> list[Any]: ...
+def reap_rotation_sentinel() -> None: ...
+def record_event(
+    kind: str,
+    branch: str,
+    worktree_path: str,
+    invoker: str,
+    outcome: str,
+    *,
+    session_id: str | None = None,
+    elapsed_ms: int | None = None,
+    correlation_id: str | None = None,
+    extra: Mapping[str, Any] | None = None,
+) -> None: ...
+def register_binding(
+    session_id: str,
+    worktree_path: str,
+    branch: str,
+    repo_root: str,
+    state_path: str | None = None,
+    source_ref: str = "",
+) -> WorktreeBinding: ...
+def resolve_git_worktree(cwd: str | None = None) -> GitWorktree | None: ...
+def resolve_github_policy(project_root: str | Path | None = None) -> GitHubPolicy: ...
+def resolve_known_worktree_bases(
+    repo_root: str | None = None, home: str | None = None
+) -> list[str]: ...
+def resolve_main_branches(project_root: str | Path | None = None) -> frozenset[str]: ...
+def resolve_project_id(repo_root: str | None = None) -> str: ...
+def resolve_state_dir_name(project_id: str | None = None) -> str: ...
+def resolve_worktree_base(
+    explicit_base: str | None = None,
+    repo_root: str | None = None,
+    home: str | None = None,
+) -> str: ...
+def resolve_worktree_dir(
+    worktree_name: str,
+    explicit_base: str | None = None,
+    repo_root: str | None = None,
+    home: str | None = None,
+) -> str: ...
+def set_noveler_project_root_for_worktree(
+    target_path: str | None = None,
+) -> dict[str, str]: ...
+def state_dir(repo_root: str | None = None) -> str: ...
+def store_relative_path(project_id: str | None = None) -> Path: ...
+def validate_binding(
+    binding: WorktreeBinding, **kwargs: Any
+) -> BindingValidationResult: ...
+def validate_current_binding(**kwargs: Any) -> BindingValidationResult: ...
+def validate_main_worktree(
+    cwd: str | None = None, allowed_branches: frozenset[str] | None = None
+) -> WorktreePreconditionResult: ...
+def worktree_identity_env_vars() -> tuple[str, ...]: ...
+def worktree_runtime_env_vars() -> tuple[str, ...]: ...

worktree_runtime/api.pyi

@@ -0,0 +1,144 @@
+"""Typing stubs for worktree_runtime.api (Rust-primary public surface)."""
+
+from __future__ import annotations
+
+from collections.abc import Callable, Mapping, Sequence
+from datetime import datetime
+from pathlib import Path
+from typing import Any, Final
+
+CURRENT_SCHEMA_VERSION: Final[int]
+LEGACY_PROJECT_ID: Final[str]
+MAIN_BRANCHES: Final[frozenset[str]]
+ADAPTIVE_TASK_SHARED_DIR_ENV: Final[str]
+NOVELER_BRANCH_ENV: Final[str]
+NOVELER_PROJECT_ROOT_ENV: Final[str]
+NOVELER_REPO_ROOT_ENV: Final[str]
+NOVELER_SHARED_DIR_ENV: Final[str]
+NOVELER_STATE_DIR_ENV: Final[str]
+NOVELER_WORKTREE_BASE_ENV: Final[str]
+NOVELER_WORKTREE_ENV: Final[str]
+UV_PROJECT_ENV: Final[str]
+WORKTREE_IDENTITY_ENV_VARS: Final[tuple[str, ...]]
+WORKTREE_LOCATION_ENV_VARS: Final[tuple[str, ...]]
+WORKTREE_PROJECT_ENV_VARS: Final[tuple[str, ...]]
+WORKTREE_RUNTIME_ENV_VARS: Final[tuple[str, ...]]
+RUNTIME_IMPL: str
+
+class ProjectIdInvalidError(ValueError):
+    reason_code: str
+
+class WorktreeListError(Exception): ...
+
+class GitHubPolicy:
+    pr_title_prefixes: tuple[str, ...]
+    main_branches: frozenset[str]
+    pr_title_issue_suffix_required: bool
+    required_sections_issue: tuple[str, ...]
+    required_sections_pr: tuple[str, ...]
+
+class GitWorktree:
+    git_dir: str
+    git_common_dir: str
+    toplevel: str
+    branch: str
+    def is_main_worktree(self) -> bool: ...
+    def is_main_branch(self) -> bool: ...
+
+class WorktreeListEntry:
+    worktree: Path
+    branch: str | None
+    head: str
+    bare: bool
+    detached: bool
+    locked: bool
+    lock_reason: str | None
+    prunable: bool
+
+class BindingValidationOptions: ...
+class BindingValidationResult: ...
+class WorktreeBinding:
+    session_id: str
+    worktree: str
+    branch: str
+    state_path: str
+    git_common_dir: str
+    main_worktree: str
+    commit_ish: str
+    schema_version: int
+    def to_dict(self) -> dict[str, Any]: ...
+class WorktreeBindingStore: ...
+class WorktreePreconditionResult: ...
+
+def path_fingerprint(input_path: str) -> str: ...
+def is_main_worktree(context: GitWorktree) -> bool: ...
+def list_worktrees(
+    repo_root: Path,
+    *,
+    run: Callable[[Sequence[str], Path], Any] | None = None,
+) -> tuple[WorktreeListEntry, ...]: ...
+def list_bindings(repo_root: str) -> tuple[WorktreeBinding, ...]: ...
+def load_binding(session_id: str, repo_root: str) -> WorktreeBinding | None: ...
+def normalize_path(raw_path: str = "") -> str: ...
+def recover_binding(session_id: str, repo_root: str) -> WorktreeBinding | None: ...
+def remove_binding(session_id: str, repo_root: str) -> WorktreeBinding | None: ...
+def read_records(
+    branch: str | None = None,
+    worktree_path: str | None = None,
+    since: datetime | None = None,
+    until: datetime | None = None,
+) -> list[Any]: ...
+def reap_rotation_sentinel() -> None: ...
+def record_event(
+    kind: str,
+    branch: str,
+    worktree_path: str,
+    invoker: str,
+    outcome: str,
+    *,
+    session_id: str | None = None,
+    elapsed_ms: int | None = None,
+    correlation_id: str | None = None,
+    extra: Mapping[str, Any] | None = None,
+) -> None: ...
+def register_binding(
+    session_id: str,
+    worktree_path: str,
+    branch: str,
+    repo_root: str,
+    state_path: str | None = None,
+    source_ref: str = "",
+) -> WorktreeBinding: ...
+def resolve_git_worktree(cwd: str | None = None) -> GitWorktree | None: ...
+def resolve_github_policy(project_root: str | Path | None = None) -> GitHubPolicy: ...
+def resolve_known_worktree_bases(
+    repo_root: str | None = None, home: str | None = None
+) -> list[str]: ...
+def resolve_main_branches(project_root: str | Path | None = None) -> frozenset[str]: ...
+def resolve_project_id(repo_root: str | None = None) -> str: ...
+def resolve_state_dir_name(project_id: str | None = None) -> str: ...
+def resolve_worktree_base(
+    explicit_base: str | None = None,
+    repo_root: str | None = None,
+    home: str | None = None,
+) -> str: ...
+def resolve_worktree_dir(
+    worktree_name: str,
+    explicit_base: str | None = None,
+    repo_root: str | None = None,
+    home: str | None = None,
+) -> str: ...
+def set_noveler_project_root_for_worktree(
+    target_path: str | None = None,
+) -> dict[str, str]: ...
+def state_dir(repo_root: str | None = None) -> str: ...
+def store_relative_path(project_id: str | None = None) -> Path: ...
+def validate_binding(
+    binding: WorktreeBinding, **kwargs: Any
+) -> BindingValidationResult: ...
+def validate_current_binding(**kwargs: Any) -> BindingValidationResult: ...
+def validate_main_worktree(
+    cwd: str | None = None, allowed_branches: frozenset[str] | None = None
+) -> WorktreePreconditionResult: ...
+def worktree_identity_env_vars() -> tuple[str, ...]: ...
+def worktree_runtime_env_vars() -> tuple[str, ...]: ...

worktree_runtime/presentation/__init__.py

@@ -0,0 +1 @@
+"""Presentation layer: CLI entrypoints for worktree runtime tooling."""