erk-shared 0.2.6__tar.gz

erk_shared-0.2.6/.gitignore

@@ -0,0 +1,22 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Testing
+.pytest_cache
+.coverage
+
+# Virtual environments
+.venv
+activate.sh
+
+# Local implementation and configuration (not tracked in git)
+.impl/
+.erk/scratch/
+.env
+
+CLAUDE.local.md

erk_shared-0.2.6/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: erk-shared
+Version: 0.2.6
+Summary: Shared utilities and interfaces for erk and erk-kits
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1.7
+Requires-Dist: python-frontmatter>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Description-Content-Type: text/markdown
+
+# erk-shared
+
+Shared utilities and interfaces for erk and erk-kits packages.
+
+This package provides:
+
+- **GitHub Issues Interface**: ABC with Real/Fake implementations
+- **Naming Utilities**: Filename and worktree name transformations
+- **Metadata Blocks**: GitHub comment formatting utilities
+- **Impl Folder Utilities**: Issue reference management and progress parsing
+
+## Purpose
+
+This package exists to break the circular dependency between `erk` and `erk-kits`:
+
+- `erk` imports kit utilities from `erk-kits`
+- `erk-kits` imports interfaces and utilities from `erk`
+
+By extracting shared code to `erk-shared`, we create an acyclic dependency graph:
+
+```
+erk-shared (no dependencies)
+    ↑
+    |
+erk-kits (depends on: erk-shared)
+    ↑
+    |
+erk (depends on: erk-kits, erk-shared)
+```
+
+## Note
+
+This is an internal workspace package, not published to PyPI.

erk_shared-0.2.6/README.md

@@ -0,0 +1,33 @@
+# erk-shared
+
+Shared utilities and interfaces for erk and erk-kits packages.
+
+This package provides:
+
+- **GitHub Issues Interface**: ABC with Real/Fake implementations
+- **Naming Utilities**: Filename and worktree name transformations
+- **Metadata Blocks**: GitHub comment formatting utilities
+- **Impl Folder Utilities**: Issue reference management and progress parsing
+
+## Purpose
+
+This package exists to break the circular dependency between `erk` and `erk-kits`:
+
+- `erk` imports kit utilities from `erk-kits`
+- `erk-kits` imports interfaces and utilities from `erk`
+
+By extracting shared code to `erk-shared`, we create an acyclic dependency graph:
+
+```
+erk-shared (no dependencies)
+    ↑
+    |
+erk-kits (depends on: erk-shared)
+    ↑
+    |
+erk (depends on: erk-kits, erk-shared)
+```
+
+## Note
+
+This is an internal workspace package, not published to PyPI.

erk_shared-0.2.6/pyproject.toml

@@ -0,0 +1,24 @@
+[project]
+name = "erk-shared"
+version = "0.2.6"
+description = "Shared utilities and interfaces for erk and erk-kits"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "pyyaml>=6.0",
+    "python-frontmatter>=1.0.0",
+    "click>=8.1.7",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/erk_shared"]
+
+[tool.pyright]
+include = ["src", "tests"]
+pythonVersion = "3.11"
+typeCheckingMode = "strict"
+reportPrivateUsage = false

erk_shared-0.2.6/src/erk_shared/__init__.py

@@ -0,0 +1,20 @@
+"""Shared utilities and interfaces for erk and erk-kits.
+
+Import from submodules:
+- env: in_github_actions
+- git.abc: Git, WorktreeInfo, find_worktree_for_branch
+- git.real: RealGit
+- github.abc: GitHub
+- github.types: PRInfo, PRMergeability, PRState, PullRequestInfo, WorkflowRun
+- github.issues: GitHubIssues, RealGitHubIssues, FakeGitHubIssues, etc.
+- github.metadata: MetadataBlock, create_metadata_block, etc.
+- impl_folder: IssueReference, read_issue_reference, etc.
+- naming: sanitize_worktree_name, generate_filename_from_title
+- output.output: user_output, machine_output, format_duration
+- subprocess_utils: run_subprocess_with_context
+- integrations.graphite.*: Graphite, RealGraphite, FakeGraphite, etc.
+- integrations.time.*: Time, RealTime
+- integrations.parallel.*: ParallelTaskRunner, RealParallelTaskRunner
+"""
+
+__version__ = "0.1.0"

erk_shared-0.2.6/src/erk_shared/context/__init__.py

@@ -0,0 +1,10 @@
+"""Unified context for erk and erk-kits.
+
+This module provides the canonical ErkContext that holds all dependencies
+for erk and erk-kits operations.
+
+Note: Import helpers from erk_shared.context.helpers and types from
+erk_shared.context.types directly.
+"""
+
+from erk_shared.context.context import ErkContext as ErkContext

erk_shared-0.2.6/src/erk_shared/context/context.py

@@ -0,0 +1,177 @@
+"""Unified context for erk and erk-kits operations.
+
+This module provides ErkContext - the unified context that holds all dependencies
+for erk and erk-kits operations.
+
+The ABCs for erk-specific services (ClaudeExecutor, ConfigStore, ScriptWriter,
+PlannerRegistry, PlanListService) are defined in erk_shared.core, enabling
+proper type hints without circular imports. Real implementations remain in erk.
+"""
+
+from dataclasses import dataclass
+from pathlib import Path
+
+from erk_shared.context.types import (
+    GlobalConfig,
+    LoadedConfig,
+    NoRepoSentinel,
+    RepoContext,
+)
+from erk_shared.core.claude_executor import ClaudeExecutor
+from erk_shared.core.config_store import ConfigStore
+from erk_shared.core.plan_list_service import PlanListService
+from erk_shared.core.planner_registry import PlannerRegistry
+from erk_shared.core.script_writer import ScriptWriter
+from erk_shared.extraction.claude_code_session_store import ClaudeCodeSessionStore
+from erk_shared.git.abc import Git
+from erk_shared.github.abc import GitHub
+from erk_shared.github.issues import GitHubIssues
+from erk_shared.github.types import RepoInfo
+from erk_shared.integrations.completion import Completion
+from erk_shared.integrations.feedback import UserFeedback
+from erk_shared.integrations.graphite.abc import Graphite
+from erk_shared.integrations.shell import Shell
+from erk_shared.integrations.time.abc import Time
+from erk_shared.objectives.storage import ObjectiveStore
+from erk_shared.plan_store.store import PlanStore
+from erk_shared.project_discovery import ProjectContext
+from erk_shared.prompt_executor import PromptExecutor
+
+
+@dataclass(frozen=True)
+class ErkContext:
+    """Immutable context holding all dependencies for erk and erk-kits operations.
+
+    Created at CLI entry point and threaded through the application via Click's
+    context system. Frozen to prevent accidental modification at runtime.
+
+    This unified context replaces both the old ErkContext (from erk.core.context)
+    and DotAgentContext (from erk_kits.context).
+
+    Note:
+    - global_config may be None only during init command before config is created.
+      All other commands should have a valid GlobalConfig.
+
+    DotAgentContext Compatibility:
+    - github_issues -> issues (renamed for consistency)
+    - repo_root property -> repo.root (access via repo property or require_repo_root helper)
+    - debug field -> debug (preserved)
+    """
+
+    # Gateway integrations (from erk_shared)
+    git: Git
+    github: GitHub
+    issues: GitHubIssues  # Note: ErkContext naming (was github_issues in DotAgentContext)
+    graphite: Graphite
+    time: Time
+    session_store: ClaudeCodeSessionStore
+    plan_store: PlanStore
+    objectives: ObjectiveStore
+    prompt_executor: PromptExecutor  # From DotAgentContext
+
+    # Shell/CLI integrations (moved to erk_shared)
+    shell: Shell
+    completion: Completion
+    feedback: UserFeedback
+
+    # Erk-specific services (ABCs now in erk_shared.core for proper type hints)
+    claude_executor: ClaudeExecutor
+    config_store: ConfigStore
+    script_writer: ScriptWriter
+    planner_registry: PlannerRegistry
+    plan_list_service: PlanListService
+
+    # Paths
+    cwd: Path  # Current working directory at CLI invocation
+
+    # Repository context
+    repo: RepoContext | NoRepoSentinel
+    project: ProjectContext | None  # None if not in a project subdirectory
+    repo_info: RepoInfo | None  # None when not in a GitHub repo
+
+    # Configuration
+    global_config: GlobalConfig | None
+    local_config: LoadedConfig
+
+    # Mode flags
+    dry_run: bool
+    debug: bool  # From DotAgentContext
+
+    @property
+    def repo_root(self) -> Path:
+        """DotAgentContext compatibility - get repo root from repo.
+
+        Raises:
+            RuntimeError: If not in a git repository
+        """
+        if isinstance(self.repo, NoRepoSentinel):
+            raise RuntimeError("Not in a git repository")
+        return self.repo.root
+
+    @property
+    def trunk_branch(self) -> str | None:
+        """Get the trunk branch name from git detection.
+
+        Returns None if not in a repository, otherwise uses git to detect trunk.
+        """
+        if isinstance(self.repo, NoRepoSentinel):
+            return None
+        return self.git.detect_trunk_branch(self.repo.root)
+
+    @property
+    def github_issues(self) -> GitHubIssues:
+        """DotAgentContext compatibility - alias for issues field.
+
+        Deprecated: Use ctx.issues instead. This property is provided for
+        backward compatibility with code written for the old DotAgentContext.
+        """
+        return self.issues
+
+    @staticmethod
+    def for_test(
+        github_issues: GitHubIssues | None = None,
+        git: Git | None = None,
+        github: GitHub | None = None,
+        session_store: ClaudeCodeSessionStore | None = None,
+        prompt_executor: PromptExecutor | None = None,
+        debug: bool = False,
+        repo_root: Path | None = None,
+        cwd: Path | None = None,
+    ) -> "ErkContext":
+        """Create test context with optional pre-configured implementations.
+
+        Provides full control over all context parameters with sensible test defaults
+        for any unspecified values. Uses fakes by default to avoid subprocess calls.
+
+        Args:
+            github_issues: Optional GitHubIssues implementation. If None, creates FakeGitHubIssues.
+            git: Optional Git implementation. If None, creates FakeGit.
+            github: Optional GitHub implementation. If None, creates FakeGitHub.
+            session_store: Optional SessionStore. If None, creates FakeClaudeCodeSessionStore.
+            prompt_executor: Optional PromptExecutor. If None, creates FakePromptExecutor.
+            debug: Whether to enable debug mode (default False).
+            repo_root: Repository root path (defaults to Path("/fake/repo"))
+            cwd: Current working directory (defaults to Path("/fake/worktree"))
+
+        Returns:
+            ErkContext configured with provided values and test defaults
+
+        Example:
+            >>> from erk_shared.github.issues import FakeGitHubIssues
+            >>> from erk_shared.git.fake import FakeGit
+            >>> github = FakeGitHubIssues()
+            >>> git_ops = FakeGit()
+            >>> ctx = ErkContext.for_test(github_issues=github, git=git_ops, debug=True)
+        """
+        from erk_shared.context.testing import context_for_test
+
+        return context_for_test(
+            github_issues=github_issues,
+            git=git,
+            github=github,
+            session_store=session_store,
+            prompt_executor=prompt_executor,
+            debug=debug,
+            repo_root=repo_root,
+            cwd=cwd,
+        )

erk_shared-0.2.6/src/erk_shared/context/factories.py

@@ -0,0 +1,141 @@
+"""Factory functions for creating ErkContext instances.
+
+This module provides factory functions for creating production contexts
+with real implementations. Used by CLI entry points.
+"""
+
+import subprocess
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from erk_shared.core.fakes import (
+    FakeClaudeExecutor,
+    FakeConfigStore,
+    FakePlanListService,
+    FakePlannerRegistry,
+    FakeScriptWriter,
+)
+
+if TYPE_CHECKING:
+    from erk_shared.context.context import ErkContext
+    from erk_shared.git.abc import Git
+    from erk_shared.github.types import RepoInfo
+
+
+def get_repo_info(git: "Git", repo_root: Path) -> "RepoInfo | None":
+    """Detect repository info from git remote URL.
+
+    Parses the origin remote URL to extract owner/name for GitHub API calls.
+    Returns None if no origin remote is configured or URL cannot be parsed.
+
+    Args:
+        git: Git interface for operations
+        repo_root: Repository root path
+
+    Returns:
+        RepoInfo with owner/name, or None if not determinable
+    """
+    from erk_shared.github.parsing import parse_git_remote_url
+    from erk_shared.github.types import RepoInfo
+
+    try:
+        remote_url = git.get_remote_url(repo_root)
+        owner, name = parse_git_remote_url(remote_url)
+        return RepoInfo(owner=owner, name=name)
+    except ValueError:
+        return None
+
+
+def create_minimal_context(*, debug: bool, cwd: Path | None = None) -> "ErkContext":
+    """Create production context with real implementations for erk-kits.
+
+    This factory creates a minimal context suitable for erk-kits commands.
+    It uses real implementations for GitHub, git, and session store, but uses
+    fake implementations for erk-specific services (ClaudeExecutor, etc.) that
+    erk-kits doesn't need.
+
+    Detects repository root using git rev-parse. Returns context with
+    NoRepoSentinel if not in a git repository.
+
+    Args:
+        debug: If True, enable debug mode (full stack traces in error handling)
+        cwd: Current working directory (defaults to Path.cwd())
+
+    Returns:
+        ErkContext with real GitHub integrations and detected repo context
+
+    Example:
+        >>> ctx = create_minimal_context(debug=False)
+        >>> issue_number = ctx.issues.create_issue(ctx.repo_root, title, body, labels)
+    """
+    from erk_shared.context.context import ErkContext
+    from erk_shared.context.types import LoadedConfig, NoRepoSentinel, RepoContext
+    from erk_shared.extraction.claude_code_session_store import RealClaudeCodeSessionStore
+    from erk_shared.git.real import RealGit
+    from erk_shared.github.issues import RealGitHubIssues
+    from erk_shared.github.real import RealGitHub
+    from erk_shared.integrations.completion import FakeCompletion
+    from erk_shared.integrations.feedback import SuppressedFeedback
+    from erk_shared.integrations.graphite.fake import FakeGraphite
+    from erk_shared.integrations.shell import FakeShell
+    from erk_shared.integrations.time.fake import FakeTime
+    from erk_shared.integrations.time.real import RealTime
+    from erk_shared.objectives.storage import FakeObjectiveStore
+    from erk_shared.plan_store.fake import FakePlanStore
+    from erk_shared.prompt_executor.real import RealPromptExecutor
+
+    resolved_cwd = cwd if cwd is not None else Path.cwd()
+
+    # Detect repo root using git rev-parse
+    result = subprocess.run(
+        ["git", "rev-parse", "--show-toplevel"],
+        capture_output=True,
+        text=True,
+        check=False,
+    )
+
+    # Create git instance
+    git = RealGit()
+
+    if result.returncode != 0:
+        # Not in a git repository
+        repo: RepoContext | NoRepoSentinel = NoRepoSentinel()
+        repo_info = None
+    else:
+        repo_root = Path(result.stdout.strip())
+        repo_info = get_repo_info(git, repo_root)
+        repo = RepoContext(
+            root=repo_root,
+            repo_name=repo_root.name,
+            repo_dir=Path.home() / ".erk" / "repos" / repo_root.name,
+            worktrees_dir=Path.home() / ".erk" / "repos" / repo_root.name / "worktrees",
+        )
+
+    # Use fake implementations for erk-specific services that erk-kits doesn't need
+    return ErkContext(
+        git=git,
+        github=RealGitHub(time=RealTime(), repo_info=repo_info),
+        issues=RealGitHubIssues(),
+        session_store=RealClaudeCodeSessionStore(),
+        prompt_executor=RealPromptExecutor(),
+        graphite=FakeGraphite(),
+        time=FakeTime(),
+        plan_store=FakePlanStore(),
+        objectives=FakeObjectiveStore(),
+        shell=FakeShell(),
+        completion=FakeCompletion(),
+        feedback=SuppressedFeedback(),
+        claude_executor=FakeClaudeExecutor(),
+        config_store=FakeConfigStore(),
+        script_writer=FakeScriptWriter(),
+        planner_registry=FakePlannerRegistry(),
+        plan_list_service=FakePlanListService(),
+        cwd=resolved_cwd,
+        repo=repo,
+        project=None,
+        repo_info=repo_info,
+        global_config=None,
+        local_config=LoadedConfig(env={}, post_create_commands=[], post_create_shell=None),
+        dry_run=False,
+        debug=debug,
+    )