npm - claude-dev-env - Versions diffs - 2.16.0 → 2.17.0 - Mend

claude-dev-env 2.16.0 → 2.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (535) hide show

package/_shared/pr-loop/scripts/pr_converge_scripts_constants/pr_converge_constants.py ADDED Viewed

@@ -0,0 +1,118 @@
+"""Configuration constants for the pr-converge skill scripts.
+Path templates accept ``str.format(**kwargs)`` substitution; bugbot strings
+match the literal phrasing the Cursor Bugbot reviewer emits.
+All runtime and API constants are imported from ``config.constants``.
+Only script-specific constants (CLI args, markdown patterns, reflow
+settings) live here.
+"""
+import re
+from pathlib import Path
+from pr_converge_skill_constants.constants import (  # noqa: F401
+    ALL_BUGBOT_CHECK_RUN_ACTIVE_STATUSES,
+    ALL_CLAUDE_DIRTY_REVIEW_STATES,
+    ALL_COPILOT_DIRTY_REVIEW_STATES,
+    ALL_BUGBOT_CHECK_RUN_COMPLETE_CONCLUSIONS,
+    BUGBOT_CHECK_RUN_NAME_SUBSTRING,
+    BUGBOT_DIRTY_BODY_REGEX,
+    BUGBOT_RUN_TRIGGER_PHRASE,
+    BUGBOT_RUN_TRIGGER_WAIT_SECONDS,
+    CHECK_RUNS_PER_PAGE,
+    ALL_CLAUDE_CLEAN_REVIEW_STATES,
+    CLAUDE_LOGIN_FILTER_SUBSTRING,
+    CLAUDE_REVIEWER_LOGIN,
+    CLAUDE_REVIEWER_REQUEST_ID,
+    CLAUDE_SOFT_DIRTY_REVIEW_STATE,
+    ALL_COPILOT_CLEAN_REVIEW_STATES,
+    COPILOT_LOGIN_FILTER_SUBSTRING,
+    COPILOT_REVIEWER_LOGIN,
+    COPILOT_REVIEWER_REQUEST_ID,
+    COPILOT_SOFT_DIRTY_REVIEW_STATE,
+    CURSOR_BOT_LOGIN,
+    CURSOR_LOGIN_FILTER_SUBSTRING,
+    EXIT_CODE_GH_ERROR,
+    EXIT_CODE_NOT_FOUND,
+    GH_CHECK_RUNS_PATH_TEMPLATE,
+    GH_INLINE_COMMENT_CREATE_PATH_TEMPLATE,
+    GH_INLINE_COMMENTS_PATH_TEMPLATE,
+    GH_ISSUE_COMMENT_CREATE_PATH_TEMPLATE,
+    GH_PR_OBJECT_PATH_TEMPLATE,
+    GH_REQUESTED_REVIEWERS_FIELD_TEMPLATE,
+    GH_REVIEW_COMMENTS_PATH_TEMPLATE,
+    GH_REVIEWS_PATH_TEMPLATE,
+)
+BUGBOT_RUN_TEMPFILE_SUFFIX: str = ".md"
+BUGBOT_RUN_TEMPFILE_PREFIX: str = "pr-converge-bugbot-run-"
+PR_CONTEXT_FIELDS: str = "number,url,headRefOid,baseRefName,headRefName,isDraft"
+PR_DETACHED_HEAD_ARGS_ERROR: str = "--owner and --repo require --number; all three must be provided together for detached-HEAD PR resolution"
+PR_NUMBER_ARG_FLAG: str = "--number"
+PR_NUMBER_ARG_HELP: str = "PR number"
+PR_OWNER_ARG_FLAG: str = "--owner"
+PR_OWNER_ARG_HELP: str = "GitHub repository owner"
+PR_REPO_ARG_FLAG: str = "--repo"
+PR_REPO_ARG_HELP: str = "GitHub repository name"
+GH_REPO_FLAG: str = "--repo"
+MERGEABILITY_FIELDS: str = "mergeable,mergeStateStatus,headRefOid"
+GH_FIELD_BODY_AT_PREFIX: str = "body=@"
+GH_REPO_ARG_TEMPLATE: str = "{owner}/{repo}"
+SKILL_REFLOW_MAXIMUM_WIDTH: int = 80
+PR_CONVERGE_SKILL_PATH: Path = Path(__file__).resolve().parent.parent.parent / "SKILL.md"
+MARKDOWN_CODE_FENCE_MARKER: str = "```"
+YAML_FRONT_MATTER_DELIMITER: str = "---"
+YAML_DESCRIPTION_PREFIX: str = "description: >-"
+EXAMPLE_OPEN_TAG: str = "<example>"
+EXAMPLE_CLOSE_TAG: str = "</example>"
+BASH_FENCE_LANGUAGE: str = "bash"
+BASH_LINE_CONTINUATION_SUFFIX: str = " \\"
+BASH_CONTINUATION_INDENT: str = "  "
+REFLOW_FRONT_MATTER_ERROR: str = "expected YAML front matter starting with ---"
+ORDERED_MARKDOWN_LIST_PATTERN: re.Pattern[str] = re.compile(
+    r"^(?P<leading_whitespace>\s*)(?P<marker>\d+\.\s)(?P<body>.*)$"
+)
+BULLET_MARKDOWN_LIST_PATTERN: re.Pattern[str] = re.compile(
+    r"^(?P<leading_whitespace>\s*)(?P<marker>[-*]\s)(?P<body>.*)$"
+)
+UNFINISHED_MARKDOWN_LINK_TARGET_PATTERN: re.Pattern[str] = re.compile(r"\]\([^)]*$")
+MARKDOWN_HEADING_PATTERN: re.Pattern[str] = re.compile(r"^#{1,6}\s+.+$")
+MARKDOWN_REFERENCE_DEFINITION_PATTERN: re.Pattern[str] = re.compile(r"^\[[^\]]+\]:\s+\S+")
+BASH_LINE_CONTINUATION_MARKER_WIDTH: int = 2
+CODE_FENCE_MARKER_LENGTH: int = 3
+BASH_MINIMUM_SEGMENT_WIDTH: int = 1
+LONG_ROW_PREVIEW_LIMIT: int = 20

package/_shared/pr-loop/scripts/pr_converge_scripts_constants/reflow_skill_md_constants.py ADDED Viewed

@@ -0,0 +1,13 @@
+"""Configuration for the pr-converge skill Markdown reflow script."""
+import re
+from pathlib import Path
+MAXIMUM_LINE_WIDTH: int = 80
+BASH_CONTINUATION_MARKER_WIDTH: int = 2
+TARGET_SKILL_PATH: Path = Path(__file__).resolve().parent.parent.parent / "SKILL.md"
+ORDERED_LIST_ITEM_PATTERN: re.Pattern[str] = re.compile(r"^(\s*)(\d+\.\s)(.*)$")
+BULLET_LIST_ITEM_PATTERN: re.Pattern[str] = re.compile(r"^(\s*)([-*]\s)(.*)$")
+UNFINISHED_MARKDOWN_LINK_TARGET_PATTERN: re.Pattern[str] = re.compile(r"\]\([^)]*$")
+MARKDOWN_REFERENCE_DEFINITION_PATTERN: re.Pattern[str] = re.compile(r"^\s*\[[^\]]+\]:\s*\S")

package/_shared/pr-loop/scripts/pr_converge_skill_constants/.claude/CLAUDE.md ADDED Viewed

	@@ -0,0 +1 @@
1	+ @../AGENTS.md

package/_shared/pr-loop/scripts/pr_converge_skill_constants/AGENTS.md ADDED Viewed

@@ -0,0 +1,26 @@
+# pr_converge_skill_constants
+Importable Python constants module for shared PR-loop convergence scripts. Script-specific constants (CLI args, markdown patterns, reflow settings) live in `pr_converge_scripts_constants/` beside this package and import from here.
+## Key files
+| File | Purpose |
+|---|---|
+| `__init__.py` | Package marker |
+| `constants.py` | All runtime and API constants: bot logins, review states, GH API path templates, bugbot/bugteam detection patterns, exit codes |
+## Exported constants (selected)
+| Constant | Purpose |
+|---|---|
+| `CURSOR_BOT_LOGIN` | Login string for the Cursor bugbot reviewer |
+| `COPILOT_REVIEWER_LOGIN` | Login string for the Copilot reviewer bot |
+| `ALL_COPILOT_CLEAN_REVIEW_STATES` | Tuple of review states that count as clean for Copilot |
+| `BUGBOT_DIRTY_BODY_REGEX` | Regex that matches a bugbot review body reporting findings |
+| `GH_REVIEWS_PATH_TEMPLATE` | `gh api` path template for PR reviews |
+| `GH_INLINE_COMMENTS_PATH_TEMPLATE` | `gh api` path template for PR inline comments |
+## Conventions
+- All path templates use `str.format(**kwargs)` with keys `owner`, `repo`, `number`.
+- `packages/claude-dev-env/_shared/pr-loop/scripts/pr_converge_scripts_constants/pr_converge_constants.py` re-exports everything here via `from pr_converge_skill_constants.constants import ...` so scripts can import from either location.

package/_shared/pr-loop/scripts/pr_converge_skill_constants/__init__.py ADDED Viewed

File without changes

package/_shared/pr-loop/scripts/pr_converge_skill_constants/constants.py ADDED Viewed

@@ -0,0 +1,69 @@
+"""Constants for shared PR-loop convergence scripts.
+All runtime and API constants live here. Script-specific constants
+(CLI args, markdown patterns, reflow settings) stay in
+``packages/claude-dev-env/_shared/pr-loop/scripts/pr_converge_scripts_constants/pr_converge_constants.py``,
+which imports from here.
+"""
+CURSOR_BOT_LOGIN = "cursor[bot]"
+CURSOR_LOGIN_FILTER_SUBSTRING = "cursor"
+COPILOT_REVIEWER_LOGIN = "copilot-pull-request-reviewer[bot]"
+COPILOT_COMMENT_LOGIN = "Copilot"
+COPILOT_REVIEWER_REQUEST_ID = COPILOT_REVIEWER_LOGIN
+COPILOT_LOGIN_FILTER_SUBSTRING = "copilot"
+CLAUDE_REVIEWER_LOGIN = "claude[bot]"
+CLAUDE_REVIEWER_REQUEST_ID = CLAUDE_REVIEWER_LOGIN
+CLAUDE_LOGIN_FILTER_SUBSTRING = "claude"
+ALL_COPILOT_CLEAN_REVIEW_STATES = ("APPROVED", "COMMENTED")
+ALL_COPILOT_DIRTY_REVIEW_STATES = ("CHANGES_REQUESTED",)
+COPILOT_SOFT_DIRTY_REVIEW_STATE = "COMMENTED"
+ALL_CLAUDE_CLEAN_REVIEW_STATES = ("APPROVED",)
+ALL_CLAUDE_DIRTY_REVIEW_STATES = ("CHANGES_REQUESTED", "COMMENTED")
+CLAUDE_SOFT_DIRTY_REVIEW_STATE = "COMMENTED"
+BUGBOT_DIRTY_BODY_REGEX = (
+    r"Cursor Bugbot has reviewed your changes and found \d+ potential issue"
+)
+BUGBOT_CHECK_RUN_NAME_SUBSTRING = "bugbot"
+ALL_BUGBOT_CHECK_RUN_ACTIVE_STATUSES = ("queued", "in_progress")
+BUGBOT_CHECK_RUN_COMPLETED_STATUS = "completed"
+ALL_BUGBOT_CHECK_RUN_COMPLETE_CONCLUSIONS = ("success", "neutral")
+BUGBOT_RUN_TRIGGER_PHRASE = "bugbot run\n"
+BUGBOT_RUN_TRIGGER_WAIT_SECONDS = 8
+BUGTEAM_NEW_HEADER_PREFIX = "**Bugteam audit completed**"
+BUGTEAM_LEGACY_HEADER_PREFIX = "## /bugteam loop "
+BUGTEAM_NEW_CLEAN_LABEL = "Clean — no findings"
+BUGTEAM_LEGACY_CLEAN_TOKEN = "→ clean"
+GH_INLINE_COMMENTS_PATH_TEMPLATE = "repos/{owner}/{repo}/pulls/{number}/comments"
+GH_REVIEW_COMMENTS_PATH_TEMPLATE = (
+    "repos/{owner}/{repo}/pulls/{number}/reviews/{review_id}/comments"
+)
+GH_REVIEWS_PATH_TEMPLATE = "repos/{owner}/{repo}/pulls/{number}/reviews"
+GH_CHECK_RUNS_PATH_TEMPLATE = "repos/{owner}/{repo}/commits/{sha}/check-runs"
+GH_INLINE_COMMENT_CREATE_PATH_TEMPLATE = (
+    "repos/{owner}/{repo}/pulls/{number}/comments"
+)
+GH_INLINE_COMMENT_REPLY_PATH_TEMPLATE = (
+    "repos/{owner}/{repo}/pulls/{number}/comments/{comment_id}/replies"
+)
+GH_ISSUE_COMMENT_CREATE_PATH_TEMPLATE = (
+    "repos/{owner}/{repo}/issues/{number}/comments"
+)
+GH_PR_OBJECT_PATH_TEMPLATE = "repos/{owner}/{repo}/pulls/{number}"
+GH_REQUESTED_REVIEWERS_PATH_TEMPLATE = (
+    "repos/{owner}/{repo}/pulls/{number}/requested_reviewers"
+)
+GH_REQUESTED_REVIEWERS_FIELD_TEMPLATE = "reviewers[]={reviewer_id}"
+CHECK_RUNS_PER_PAGE = 20
+REVIEWS_PER_PAGE = 100
+GRAPHQL_REVIEW_THREADS_PAGE_SIZE = 100
+UNRESOLVED_THREAD_DETAIL_MAX = 5
+EXIT_CODE_GH_ERROR = 2
+EXIT_CODE_NOT_FOUND = 1