claude-dev-env 4.2.0 → 4.3.0

package/.agents/skills/issue-tracker/SKILL.md

@@ -60,6 +60,12 @@ Search open and closed issues on the target repo before create. Open twin -> upd
 
 Prefer GitHub MCP. Fall back to `gh` on the same REST endpoints. Full map and `.id` rule: [reference/operation-matrix.md](reference/operation-matrix.md).
 
+Before issue creation, a full issue body edit, or an issue comment, write the
+body to a UTF-8 file and run
+`../_shared/pr-loop/scripts/durable_post_lint.py`. Use `issue-create`,
+`issue-edit`, or `issue-comment` as the action. Send the server write only
+after exit code `0`.
+
 ## Handoff input
 
 Optional issue-candidate JSON from orchestrator or closeout. Full schema and consume path: [reference/handoff-schema.md](reference/handoff-schema.md).

package/.agents/skills/pull-request/SKILL.md

@@ -0,0 +1,218 @@
+---
+name: pull-request
+description: >-
+  Validate and publish GitHub pull request actions. Triggers: create PR, open
+  pull request, edit PR, update PR body, comment on PR, review PR, publish a
+  draft PR, scoped GitHub author.
+---
+
+# Pull request
+
+## Contents
+
+- [Principle](#principle)
+- [When this applies](#when-this-applies)
+- [Constraints](#constraints)
+- [Dependencies](#dependencies)
+- [Sub-skills](#sub-skills)
+- [Task seeding](#task-seeding)
+- [Process](#process)
+- [Exit handling](#exit-handling)
+- [Examples](#examples)
+- [Gotchas](#gotchas)
+- [File index](#file-index)
+- [Folder map](#folder-map)
+
+## Principle
+
+Publish one GitHub pull request action from validated local files and a
+process-local author value. Keep the parent environment unchanged.
+
+## When this applies
+
+Use this skill for one pull request action:
+
+- Create a draft pull request.
+- Edit a pull request title or body.
+- Add a pull request comment.
+- Submit a pull request review.
+- Recover one selected legacy author record before the action.
+
+Send issue create, edit, and comment work to `issue-tracker`. Send review
+convergence to `pr-cleanup` or `autoconverge`. Send commits to
+`source-command-commit`.
+
+Require one repository and one action target. Stop before author lookup or
+network work when the repository, pull request, action, author, or required
+local file is missing or ambiguous.
+
+Use these exact refusal responses when the request belongs to another skill:
+
+- Issue action: `Use issue-tracker for this GitHub issue action.`
+- Commit or push: `Use source-command-commit for this commit or push.`
+- Missing target: `Provide one repository and one pull request action target.`
+
+## Constraints
+
+- Run local validation and privacy checks before account lookup or network work.
+- Use a body file. Do not send inline body text through the shell.
+- Keep `GITHUB_DEFAULT_ACCOUNT`, the parent environment, and global GitHub CLI
+  state unchanged.
+- Run one create, edit, comment, review, or recovery action per command.
+- Use global account switching only for one explicitly selected legacy record.
+- Read back the remote state before reporting success.
+
+## Dependencies
+
+The commands use Python 3.11 or later and the Python standard library. GitHub
+actions also require an authenticated `gh` executable. The linter and artifact
+uploader ship in this package. Set `GITHUB_DEFAULT_ACCOUNT` to one exact GitHub
+CLI login when the action needs a selected author. Leave it unset to use the
+current process environment.
+
+## Sub-skills
+
+| Skill | When | Produces | If missing |
+|---|---|---|---|
+| `pr-description-writer` | Before create or a full body rewrite | A reviewed title and body file | Stop the create or rewrite and report that authoring is required |
+| `pr-title-description` | Optional title and body review | Review findings for the writer's output | Continue with the required writer output |
+| `privacy-hygiene` | Before any durable GitHub post | A clean body and repository privacy sweep | Stop before publication and report the missing gate |
+| `issue-tracker` | Issue create, edit, or comment requests | Issue state and issue URLs | Route the request there. |
+| `pr-cleanup` | Placement, naming, sizing, or cleanup convergence | Cleanup findings or a focused PR boundary | Route the request there. |
+| `autoconverge` | Autonomous PR review and fix loops | A converged draft or ready-state decision | Route the request there. |
+| `source-command-commit` | Commit or push requests | A verified commit or pushed branch | Route the request there. |
+
+## Task seeding
+
+At the start of the work, register every item in
+`reference/publication-tasks.md` through `TaskCreate`, `TodoWrite`, or the host
+task equivalent when one is available. If no task tool is available, use the
+catalog and the running work ledger. Mark each task with `PASS`, `FAIL` plus
+file and line evidence, or `N/A` plus a reason for a conditional task.
+
+## Process
+
+### 1. Scope the action
+
+Resolve the repository, action, and selected GitHub author. For create, resolve
+the source branch, base, and head. For other actions, resolve one existing pull
+request target. Create actions publish drafts. Record the target before any write.
+
+### 2. Author the title and body
+
+For create and full body rewrite, invoke the installed
+`pr-description-writer`. Require its title and body file as the authoring
+output. `pr-title-description` may review that output. A comment or review may
+use a supplied body file when it does not rewrite the pull request description.
+
+### 3. Run the local linter
+
+Run `_shared/pr-loop/scripts/durable_post_lint.py` with the matching action and
+title or body file. Use `pr-create`, `pr-edit`, `pr-comment`, or `pr-review`.
+The linter owns the action-specific body, title, and volatile-path rules.
+
+Exit code `0` continues to the next gate. Any non-zero exit stops the action. Fix
+the named local input and rerun the linter. Do not look up the author or make a
+network call while validation fails.
+
+### 4. Run privacy and artifact checks
+
+Invoke `privacy-hygiene` before the GitHub post. Upload binary evidence with
+`scripts/gh_artifact_upload.py` and replace local artifact references with
+permanent URLs. Rerun the linter after changing the body.
+
+### 5. Resolve the process-local author
+
+Run `.agents/skills/pull-request/scripts/pull_request.py` with one structured
+action and the selected author. The command runs the linter again, resolves
+the author value, and passes it only to the child `gh` process. It never
+changes the parent environment or calls `gh auth switch`.
+
+If the selected author has no usable value, stop and report the account lookup
+failure. Never print the value.
+
+### 6. Recover a selected legacy record
+
+Run `.agents/skills/pull-request/scripts/recover_legacy_author.py
+<exact-state-file> --confirm-inactive` only when the user selects one legacy
+state file. The command checks the record's age, secure file metadata, and
+contents. The confirmation flag records that the caller verified inactivity.
+Leave every other record untouched. Delete the selected record only after a
+successful restore. Mark this step `N/A` when no legacy state file is selected.
+
+### 7. Run the action
+
+Run `pull_request.py` for exactly one of `create`, `edit`, `comment`, or
+`review`. Supply the validated body file path. Treat a non-zero exit as a
+failed publication and preserve the local inputs for retry.
+
+### 8. Read back the remote state
+
+Use the same selected process-local author for a read-only remote readback.
+Confirm the pull request URL and number, title, body, head SHA, and draft state.
+For comments and reviews, confirm the new remote entry. Report artifact URLs
+without exposing author values.
+
+## Exit handling
+
+Stop before network work when authoring, local validation, privacy, or author
+selection fails. A failed action preserves its body and any recovery record.
+Report the generic error and the next required input. A successful action ends
+only after remote readback proves the requested state.
+
+## Examples
+
+Create example: the writer produces `pr-body.md`. The linter exits `0` for
+`pr-create`. `pull_request.py create` publishes one draft pull request. The
+readback matches the title, body, head SHA, and draft state.
+
+Rejected comment example: the comment body names a worktree file. The linter
+returns a non-zero exit. No account lookup or GitHub request runs. Replace the
+path with inline text or a permanent artifact URL, then rerun.
+
+Recovery example: one old record remains after an interrupted legacy account
+swap. The user selects that exact file and confirms its session is inactive.
+The recovery command restores the named account and deletes only that record.
+
+## Gotchas
+
+- Relative body-file paths depend on the caller directory. Use an absolute path
+  when another process or worktree starts the command.
+- A record older than 30 minutes can still belong to a live session. Require
+  `--confirm-inactive` before recovery.
+- Normal pull request actions never call `gh auth switch`. If that command
+  appears outside explicit recovery, stop.
+- GitHub CLI output can contain account data. The command captures account
+  lookup and recovery output and prints only generic errors.
+
+## File index
+
+| Path | Purpose |
+|---|---|
+| `SKILL.md` | Hub for pull request publication, validation, author selection, recovery, and readback |
+| `reference/publication-tasks.md` | Ordered tasks for every publication gate |
+| `scripts/pull_request.py` | Command for author selection and create, edit, comment, and review actions |
+| `scripts/github_pr_command_constants/` | Constants for pull request actions, recovery, exit codes, and generic messages |
+| `scripts/test_pull_request.py` | Tests for `pull_request.py` |
+| `scripts/recover_legacy_author.py` | Command for one selected legacy author record |
+| `scripts/test_github_pr_command_constants.py` | Tests for the command and recovery constants |
+| `scripts/test_recover_legacy_author.py` | Tests for `recover_legacy_author.py` |
+| `_shared/pr-loop/scripts/durable_post_lint.py` | Shared action-aware title, body, and path validator |
+| `_shared/pr-loop/scripts/test_durable_post_lint.py` | Tests for the shared validator |
+| `scripts/gh_artifact_upload.py` | Helper for permanent GitHub binary evidence URLs |
+| `scripts/tests/test_gh_artifact_upload.py` | Tests for binary evidence upload |
+
+## Folder map
+
+```text
+pull-request/
+├── SKILL.md
+├── reference/
+│   └── publication-tasks.md
+└── scripts/
+    ├── pull_request.py
+    ├── github_pr_command_constants/
+    ├── recover_legacy_author.py
+    ├── test_pull_request.py
+    └── test_recover_legacy_author.py
+```

package/.agents/skills/pull-request/reference/publication-tasks.md

@@ -0,0 +1,18 @@
+# Pull request publication tasks
+
+Register each line as one session task before starting the process. Complete
+each task with `PASS`, `FAIL` plus file and line evidence, or `N/A` plus a
+reason when the task is conditional. This file is a task seed catalog, not a
+markdown progress board.
+
+1. Resolve one repository, action, and selected author. For create, resolve the source branch, base, and head. For other actions, resolve one existing pull request target. Create actions publish drafts.
+2. Invoke the required `pr-description-writer` for create or full body rewrite, then record its title and body file. `pr-title-description` may assist. Mark `N/A` for comment or review bodies that do not rewrite the pull request description.
+3. Validate every title, body, artifact, and local path input. Reject inline body input.
+4. Run `_shared/pr-loop/scripts/durable_post_lint.py` for the matching action and record exit code `0` before credential lookup or network work.
+5. Run `privacy-hygiene` before the GitHub post and record its clean result.
+6. Upload binary evidence through `scripts/gh_artifact_upload.py`, replace local references with permanent URLs, and rerun the shared body linter. Mark `N/A` when no binary evidence exists.
+7. Resolve the selected author in the child process environment and prove that the parent environment and global `gh` account remain unchanged.
+8. Run `.agents/skills/pull-request/scripts/pull_request.py` for exactly one action: `create`, `edit`, `comment`, or `review`.
+9. When the user selects a legacy state file, run `recover_legacy_author.py <exact-state-file> --confirm-inactive` for exactly that record. Preserve every other record and delete the selected record only after successful restore. Mark `N/A` otherwise.
+10. Read back the remote pull request title, body, head SHA, draft state, and requested comment or review, then record the URL and number without credentials.
+11. Mark every session task complete with evidence and report the action, remote URL, readback result, and any remaining blocker.

package/.agents/skills/pull-request/scripts/github_pr_command_constants/__init__.py

@@ -0,0 +1 @@
+"""Constants for the explicit GitHub pull request command."""

package/.agents/skills/pull-request/scripts/github_pr_command_constants/config/__init__.py

@@ -0,0 +1 @@
+"""Configuration constants for the explicit GitHub pull request command."""

package/.agents/skills/pull-request/scripts/github_pr_command_constants/config/constants.py

@@ -0,0 +1,61 @@
+"""Configuration constants for process-local GitHub pull request actions."""
+
+import re
+
+ACTION_COMMENT = "comment"
+ACTION_CREATE = "create"
+ACTION_EDIT = "edit"
+ACTION_REVIEW = "review"
+
+LINTER_ACTION_COMMENT = "pr-comment"
+LINTER_ACTION_CREATE = "pr-create"
+LINTER_ACTION_EDIT = "pr-edit"
+LINTER_ACTION_REVIEW = "pr-review"
+
+REVIEW_EVENT_APPROVE = "approve"
+REVIEW_EVENT_COMMENT = "comment"
+REVIEW_EVENT_REQUEST_CHANGES = "request-changes"
+ALL_REVIEW_FLAGS_BY_EVENT: dict[str, str] = {
+    REVIEW_EVENT_APPROVE: "--approve",
+    REVIEW_EVENT_COMMENT: "--comment",
+    REVIEW_EVENT_REQUEST_CHANGES: "--request-changes",
+}
+
+ALL_LINTER_ACTIONS_BY_COMMAND: dict[str, str] = {
+    ACTION_COMMENT: LINTER_ACTION_COMMENT,
+    ACTION_CREATE: LINTER_ACTION_CREATE,
+    ACTION_EDIT: LINTER_ACTION_EDIT,
+    ACTION_REVIEW: LINTER_ACTION_REVIEW,
+}
+
+SELECTED_ACCOUNT_ENVIRONMENT_KEY = "GITHUB_DEFAULT_ACCOUNT"
+
+ACCOUNT_LOOKUP_FAILED_MESSAGE = "error: GitHub account lookup failed\n"
+ACCOUNT_LOOKUP_EMPTY_MESSAGE = "error: GitHub account lookup returned no value\n"
+ACTION_FAILED_MESSAGE = "error: GitHub action failed\n"
+ACCOUNT_LOOKUP_FAILURE_EXIT_CODE = 1
+PACKAGE_ROOT_PARENT_INDEX = 4
+SKILLS_DIRECTORY_PARENT_INDEX = 2
+
+ALL_GH_AUTH_SWITCH_COMMAND_HEAD: tuple[str, ...] = (
+    "gh",
+    "auth",
+    "switch",
+    "--user",
+)
+LEGACY_RECORD_ACTIVE_MESSAGE = "error: selected legacy state record is active\n"
+LEGACY_RECORD_CHANGED_MESSAGE = "error: selected legacy state record changed\n"
+LEGACY_RECORD_CONFIRMATION_MESSAGE = "error: confirm inactive legacy state\n"
+LEGACY_RECORD_REJECTED_MESSAGE = "error: selected legacy state record is invalid\n"
+LEGACY_RESTORE_FAILED_MESSAGE = "error: GitHub account restore failed\n"
+LEGACY_RECORD_INACTIVE_CONFIRMATION_FLAG = "--confirm-inactive"
+LEGACY_RECORD_ORIGINAL_ACCOUNT_KEY = "original_account"
+LEGACY_RECORD_PERMISSION_MODE = 0o600
+LEGACY_RECORD_STALE_AGE_SECONDS = 1800
+LEGACY_RECORD_NAME_PATTERN: re.Pattern[str] = re.compile(
+    r"^gh_pr_author_swap_[A-Za-z0-9_-]+\.json$"
+)
+RECOVERY_CLEAN_EXIT_CODE = 0
+RECOVERY_FAILED_EXIT_CODE = 1
+RECOVERY_REJECTED_EXIT_CODE = 2
+RECOVERY_UNRESOLVED_EXIT_CODE = 3

package/.agents/skills/pull-request/scripts/pull_request.py

@@ -0,0 +1,276 @@
+"""Run validated GitHub pull request actions with process-local account selection."""
+
+from __future__ import annotations
+
+import argparse
+import importlib
+import os
+import subprocess
+import sys
+from collections.abc import Callable, Mapping, Sequence
+from pathlib import Path
+
+from github_pr_command_constants.config.constants import (
+    ACCOUNT_LOOKUP_EMPTY_MESSAGE,
+    ACCOUNT_LOOKUP_FAILED_MESSAGE,
+    ACCOUNT_LOOKUP_FAILURE_EXIT_CODE,
+    ACTION_COMMENT,
+    ACTION_CREATE,
+    ACTION_EDIT,
+    ACTION_FAILED_MESSAGE,
+    ACTION_REVIEW,
+    ALL_LINTER_ACTIONS_BY_COMMAND,
+    ALL_REVIEW_FLAGS_BY_EVENT,
+    PACKAGE_ROOT_PARENT_INDEX,
+    REVIEW_EVENT_COMMENT,
+    SELECTED_ACCOUNT_ENVIRONMENT_KEY,
+    SKILLS_DIRECTORY_PARENT_INDEX,
+)
+
+CommandRunner = Callable[..., subprocess.CompletedProcess[str]]
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(description=__doc__, allow_abbrev=False)
+    all_actions = parser.add_subparsers(dest="action", required=True)
+    create = all_actions.add_parser(ACTION_CREATE, allow_abbrev=False)
+    create.add_argument("--repo", required=True)
+    create.add_argument("--base", required=True)
+    create.add_argument("--head", required=True)
+    create.add_argument("--title", required=True)
+    create.add_argument("--body-file", required=True, type=Path)
+    edit = all_actions.add_parser(ACTION_EDIT, allow_abbrev=False)
+    edit.add_argument("--repo", required=True)
+    edit.add_argument("--number", required=True)
+    edit.add_argument("--title")
+    edit.add_argument("--body-file", type=Path)
+    comment = all_actions.add_parser(ACTION_COMMENT, allow_abbrev=False)
+    comment.add_argument("--repo", required=True)
+    comment.add_argument("--number", required=True)
+    comment.add_argument("--body-file", required=True, type=Path)
+    review = all_actions.add_parser(ACTION_REVIEW, allow_abbrev=False)
+    review.add_argument("--repo", required=True)
+    review.add_argument("--number", required=True)
+    review.add_argument("--body-file", required=True, type=Path)
+    review.add_argument(
+        "--event",
+        choices=tuple(ALL_REVIEW_FLAGS_BY_EVENT),
+        default=REVIEW_EVENT_COMMENT,
+    )
+    return parser
+
+
+def _linter_path() -> Path:
+    return (
+        Path(__file__).resolve().parents[SKILLS_DIRECTORY_PARENT_INDEX]
+        / "_shared/pr-loop/scripts/durable_post_lint.py"
+    )
+
+
+def _linter_arguments(arguments: argparse.Namespace) -> list[str]:
+    all_arguments = [
+        sys.executable,
+        str(_linter_path()),
+        "--action",
+        ALL_LINTER_ACTIONS_BY_COMMAND[arguments.action],
+    ]
+    if getattr(arguments, "title", None) is not None:
+        all_arguments.extend(["--title", arguments.title])
+    if getattr(arguments, "body_file", None) is not None:
+        all_arguments.extend(["--body-file", str(arguments.body_file)])
+    return all_arguments
+
+
+def _create_arguments(arguments: argparse.Namespace) -> list[str]:
+    return [
+        "gh",
+        "pr",
+        "create",
+        "--draft",
+        "--repo",
+        arguments.repo,
+        "--base",
+        arguments.base,
+        "--head",
+        arguments.head,
+        "--title",
+        arguments.title,
+        "--body-file",
+        str(arguments.body_file),
+    ]
+
+
+def _edit_arguments(arguments: argparse.Namespace) -> list[str]:
+    all_arguments = ["gh", "pr", "edit", arguments.number, "--repo", arguments.repo]
+    if arguments.title is not None:
+        all_arguments.extend(["--title", arguments.title])
+    if arguments.body_file is not None:
+        all_arguments.extend(["--body-file", str(arguments.body_file)])
+    return all_arguments
+
+
+def _post_arguments(arguments: argparse.Namespace) -> list[str]:
+    if arguments.action == ACTION_CREATE:
+        return _create_arguments(arguments)
+    if arguments.action == ACTION_EDIT:
+        return _edit_arguments(arguments)
+    if arguments.action == ACTION_COMMENT:
+        return [
+            "gh",
+            "pr",
+            "comment",
+            arguments.number,
+            "--repo",
+            arguments.repo,
+            "--body-file",
+            str(arguments.body_file),
+        ]
+    return [
+        "gh",
+        "pr",
+        "review",
+        arguments.number,
+        "--repo",
+        arguments.repo,
+        ALL_REVIEW_FLAGS_BY_EVENT[arguments.event],
+        "--body-file",
+        str(arguments.body_file),
+    ]
+
+
+def _shared_environment_key_names() -> tuple[str, str, tuple[str, ...]]:
+    shared_directory = (
+        Path(__file__).resolve().parents[PACKAGE_ROOT_PARENT_INDEX]
+        / "_shared/pr-loop/scripts"
+    )
+    shared_directory_text = str(shared_directory)
+    if shared_directory_text not in sys.path:
+        sys.path.insert(0, shared_directory_text)
+    constants_module = importlib.import_module(
+        "pr_loop_shared_constants.post_audit_thread_constants"
+    )
+    return (
+        constants_module.GITHUB_TOKEN_ENV_VAR_NAME,
+        constants_module.GH_TOKEN_ENV_VAR_NAME,
+        constants_module.ALL_GH_TOKEN_ENV_VAR_NAMES,
+    )
+
+
+def _lookup_environment(all_environment: Mapping[str, str]) -> dict[str, str]:
+    lookup_environment = dict(all_environment)
+    _, _, all_authorization_names = _shared_environment_key_names()
+    for each_name in all_authorization_names:
+        lookup_environment.pop(each_name, None)
+    return lookup_environment
+
+
+def _lookup_account_authorization(
+    selected_account: str,
+    all_environment: Mapping[str, str],
+    command_runner: CommandRunner,
+) -> str | None:
+    try:
+        completed_lookup = command_runner(
+            ["gh", "auth", "token", "--user", selected_account],
+            capture_output=True,
+            check=False,
+            env=_lookup_environment(all_environment),
+            shell=False,
+            text=True,
+        )
+    except OSError:
+        sys.stderr.write(ACCOUNT_LOOKUP_FAILED_MESSAGE)
+        return None
+    if completed_lookup.returncode != 0:
+        sys.stderr.write(ACCOUNT_LOOKUP_FAILED_MESSAGE)
+        return None
+    account_authorization = completed_lookup.stdout.strip()
+    if not account_authorization:
+        sys.stderr.write(ACCOUNT_LOOKUP_EMPTY_MESSAGE)
+        return None
+    return account_authorization
+
+
+def _action_environment(
+    all_environment: Mapping[str, str],
+    command_runner: CommandRunner,
+) -> dict[str, str] | None:
+    selected_account = all_environment.get(SELECTED_ACCOUNT_ENVIRONMENT_KEY)
+    if not selected_account:
+        return dict(all_environment)
+    account_authorization = _lookup_account_authorization(
+        selected_account, all_environment, command_runner
+    )
+    if account_authorization is None:
+        return None
+    parent_authorization_name, child_authorization_name, _ = (
+        _shared_environment_key_names()
+    )
+    action_environment = dict(all_environment)
+    action_environment.pop(parent_authorization_name, None)
+    action_environment[child_authorization_name] = account_authorization
+    return action_environment
+
+
+def _run_post_action(
+    arguments: argparse.Namespace,
+    all_action_environment: Mapping[str, str],
+    command_runner: CommandRunner,
+) -> int:
+    try:
+        completed_action = command_runner(
+            _post_arguments(arguments),
+            check=False,
+            env=all_action_environment,
+            shell=False,
+        )
+    except OSError:
+        sys.stderr.write(ACTION_FAILED_MESSAGE)
+        return ACCOUNT_LOOKUP_FAILURE_EXIT_CODE
+    return completed_action.returncode
+
+
+def _run_action(
+    arguments: argparse.Namespace,
+    all_environment: Mapping[str, str],
+    command_runner: CommandRunner,
+) -> int:
+    action_environment = _action_environment(all_environment, command_runner)
+    if action_environment is None:
+        return ACCOUNT_LOOKUP_FAILURE_EXIT_CODE
+    return _run_post_action(arguments, action_environment, command_runner)
+
+
+def main(
+    all_arguments: Sequence[str],
+    *,
+    all_environment: Mapping[str, str],
+    command_runner: CommandRunner,
+) -> int:
+    """Run one validated pull request action.
+
+    Args:
+        all_arguments: Command arguments after the script name.
+        all_environment: Parent environment copied for child processes.
+        command_runner: Process runner used by tests and production.
+
+    Returns:
+        The linter, account lookup, or GitHub action exit status.
+    """
+    arguments = _build_parser().parse_args(list(all_arguments))
+    completed_lint = command_runner(
+        _linter_arguments(arguments), check=False, shell=False
+    )
+    if completed_lint.returncode != 0:
+        return completed_lint.returncode
+    return _run_action(arguments, all_environment, command_runner)
+
+
+if __name__ == "__main__":
+    raise SystemExit(
+        main(
+            sys.argv[1:],
+            all_environment=os.environ,
+            command_runner=subprocess.run,
+        )
+    )