claude-dev-env 4.3.0 → 7.0.0

package/.agents/skills/_shared/pr-loop/scripts/build_audit_prompt.py

@@ -1,289 +0,0 @@
-"""Emit the complete AUDIT spawn prompt XML to stdout.
-
-Builds <context> and <scope> from CLI args; <bug_categories>,
-<rubric_reference>, and <constraints> come from the shared constants in
-skills_pr_loop_constants; <comment_posting> and <output_format> follow
-``--flavor`` (agent or headless). <pr_description> carries the PR body
-text read from --pr-body-file, and stays empty when that argument is
-absent or the file cannot be read.
-
-Usage:
-  python scripts/build_audit_prompt.py --owner jl-cmd --repo claude-dev-env --pr-number 422 --loop 1 --head-ref feat/branch --base-ref main --worktree-path <PATH> --run-temp-dir <PATH> [--flavor agent|headless]
-"""
-
-from __future__ import annotations
-
-import argparse
-import sys
-from xml.etree.ElementTree import Element, SubElement
-from pathlib import Path
-
-_self_dir = Path(__file__).resolve().parent
-if str(_self_dir) not in sys.path:
-    sys.path.insert(0, str(_self_dir))
-
-from _path_resolver import outcome_xml_path
-from _xml_utils import emit_pretty_xml
-from skills_pr_loop_constants.path_resolver_constants import (
-    ALL_AUDIT_CATEGORY_ENTRIES,
-    ALL_AUDIT_CONSTRAINT_TEXTS,
-    ALL_AUDIT_PROMPT_FLAVORS,
-    AUDIT_COMMENT_POSTING_AGENT_TEXT,
-    AUDIT_COMMENT_POSTING_HEADLESS_TEXT,
-    AUDIT_OUTPUT_FORMAT_AGENT_TEXT,
-    AUDIT_OUTPUT_FORMAT_HEADLESS_TEMPLATE,
-    AUDIT_PROMPT_FLAVOR_AGENT,
-    AUDIT_PROMPT_FLAVOR_HEADLESS,
-    AUDIT_RUBRIC_REFERENCE_TEXT,
-)
-
-
-def read_pr_body_text(pr_body_file: Path | None) -> str | None:
-    """Read the PR description body from a file when given and readable.
-
-    Args:
-        pr_body_file: Path to a file holding the PR description body, or None.
-
-    Returns:
-        The file's text when the path is given and readable, otherwise None.
-    """
-    if pr_body_file is None:
-        return None
-    try:
-        return pr_body_file.read_text(encoding="utf-8")
-    except OSError:
-        return None
-
-
-def _append_pr_description(root: Element, pr_body_text: str | None) -> None:
-    """Append a <pr_description> element carrying the PR body text.
-
-    Args:
-        root: Root element the <pr_description> child is appended to.
-        pr_body_text: PR description body text, or None when unavailable.
-
-    Returns:
-        None.
-    """
-    pr_description = SubElement(root, "pr_description")
-    if pr_body_text:
-        pr_description.text = pr_body_text
-
-
-def _comment_posting_text(flavor: str) -> str:
-    """Return the <comment_posting> body for the given prompt flavor.
-
-    Args:
-        flavor: ``agent`` or ``headless`` prompt flavor.
-
-    Returns:
-        Comment-posting instruction text for that flavor.
-    """
-    if flavor == AUDIT_PROMPT_FLAVOR_HEADLESS:
-        return AUDIT_COMMENT_POSTING_HEADLESS_TEXT
-    return AUDIT_COMMENT_POSTING_AGENT_TEXT
-
-
-def _format_instruction_text(
-    *,
-    flavor: str,
-    worktree_path: Path,
-    pr_number: int,
-    loop: int,
-) -> str:
-    """Return the <output_format> body for the given prompt flavor.
-
-    Args:
-        flavor: ``agent`` or ``headless`` prompt flavor.
-        worktree_path: Path to the git worktree.
-        pr_number: Pull request number.
-        loop: Loop iteration number.
-
-    Returns:
-        Format-instruction text for that flavor.
-    """
-    if flavor == AUDIT_PROMPT_FLAVOR_HEADLESS:
-        outcome_path = outcome_xml_path(worktree_path, pr_number, loop)
-        return AUDIT_OUTPUT_FORMAT_HEADLESS_TEMPLATE.format(
-            outcome_path=outcome_path.as_posix(),
-        )
-    return AUDIT_OUTPUT_FORMAT_AGENT_TEXT
-
-
-def build_audit_prompt_xml(
-    *,
-    owner: str,
-    repo: str,
-    pr_number: int,
-    loop: int,
-    head_ref: str,
-    base_ref: str,
-    worktree_path: Path,
-    run_temp_dir: Path,
-    pr_body_text: str | None = None,
-    flavor: str = AUDIT_PROMPT_FLAVOR_AGENT,
-) -> Element:
-    """Build the complete AUDIT spawn prompt XML.
-
-    Args:
-        owner: GitHub repository owner.
-        repo: GitHub repository name.
-        pr_number: Pull request number.
-        loop: Loop iteration number.
-        head_ref: Head branch ref.
-        base_ref: Base branch ref.
-        worktree_path: Path to the git worktree.
-        run_temp_dir: Path to the run temp directory.
-        pr_body_text: PR description body text, or None when unavailable.
-        flavor: Prompt flavor — ``agent`` (MCP posting) or ``headless``
-            (outcome file, lead-owned posting).
-
-    Returns:
-        Root <spawn_prompt> element.
-    """
-    root = Element("spawn_prompt", {"role": "audit", "loop": str(loop)})
-
-    context = SubElement(root, "context")
-    SubElement(context, "owner").text = owner
-    SubElement(context, "repo").text = repo
-    SubElement(context, "pr_number").text = str(pr_number)
-    SubElement(context, "head_ref").text = head_ref
-    SubElement(context, "base_ref").text = base_ref
-    SubElement(context, "worktree_path").text = worktree_path.as_posix()
-    SubElement(context, "run_temp_dir").text = run_temp_dir.as_posix()
-
-    scope = SubElement(root, "scope")
-    scope.text = (
-        f"Audit the full diff of {owner}/{repo}#{pr_number} "
-        f"({head_ref} against {base_ref}) for CODE_RULES violations, "
-        f"bugs, and anti-patterns. Work in {worktree_path.as_posix()}."
-    )
-
-    _append_pr_description(root, pr_body_text)
-
-    bug_categories = SubElement(root, "bug_categories")
-    for each_category_id, each_category_label in ALL_AUDIT_CATEGORY_ENTRIES:
-        cat_elem = SubElement(bug_categories, "category", {"id": each_category_id})
-        cat_elem.text = each_category_label
-
-    rubric_reference = SubElement(root, "rubric_reference")
-    rubric_reference.text = AUDIT_RUBRIC_REFERENCE_TEXT
-
-    constraints = SubElement(root, "constraints")
-    for each_constraint in ALL_AUDIT_CONSTRAINT_TEXTS:
-        SubElement(constraints, "constraint").text = each_constraint
-
-    comment_posting = SubElement(root, "comment_posting")
-    comment_posting.text = _comment_posting_text(flavor)
-
-    format_section = SubElement(root, "output_format")
-    format_section.text = _format_instruction_text(
-        flavor=flavor,
-        worktree_path=worktree_path,
-        pr_number=pr_number,
-        loop=loop,
-    )
-
-    return root
-
-
-def emit_audit_prompt(
-    *,
-    owner: str,
-    repo: str,
-    pr_number: int,
-    loop: int,
-    head_ref: str,
-    base_ref: str,
-    worktree_path: Path,
-    run_temp_dir: Path,
-    pr_body_text: str | None = None,
-    flavor: str = AUDIT_PROMPT_FLAVOR_AGENT,
-) -> str:
-    """Build and serialize the AUDIT spawn prompt to a pretty-printed XML string.
-
-    Args:
-        owner: GitHub repository owner.
-        repo: GitHub repository name.
-        pr_number: Pull request number.
-        loop: Loop iteration number.
-        head_ref: Head branch ref.
-        base_ref: Base branch ref.
-        worktree_path: Path to the git worktree.
-        run_temp_dir: Path to the run temp directory.
-        pr_body_text: PR description body text, or None when unavailable.
-        flavor: Prompt flavor — ``agent`` or ``headless``.
-
-    Returns:
-        Pretty-printed XML string.
-    """
-    root = build_audit_prompt_xml(
-        owner=owner,
-        repo=repo,
-        pr_number=pr_number,
-        loop=loop,
-        head_ref=head_ref,
-        base_ref=base_ref,
-        worktree_path=worktree_path,
-        run_temp_dir=run_temp_dir,
-        pr_body_text=pr_body_text,
-        flavor=flavor,
-    )
-    return emit_pretty_xml(root)
-
-
-def parse_arguments(all_argv: list[str]) -> argparse.Namespace:
-    """Parse command-line arguments.
-
-    Args:
-        all_argv: Command-line argument list.
-
-    Returns:
-        Parsed namespace with all required audit prompt parameters.
-    """
-    parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument("--owner", required=True)
-    parser.add_argument("--repo", required=True)
-    parser.add_argument("--pr-number", type=int, required=True)
-    parser.add_argument("--loop", type=int, required=True)
-    parser.add_argument("--head-ref", required=True)
-    parser.add_argument("--base-ref", required=True)
-    parser.add_argument("--worktree-path", type=Path, required=True)
-    parser.add_argument("--run-temp-dir", type=Path, required=True)
-    parser.add_argument("--pr-body-file", type=Path, default=None)
-    parser.add_argument(
-        "--flavor",
-        choices=sorted(ALL_AUDIT_PROMPT_FLAVORS),
-        default=AUDIT_PROMPT_FLAVOR_AGENT,
-    )
-    return parser.parse_args(all_argv)
-
-
-def main(all_arguments: list[str]) -> int:
-    """Entry point: emit AUDIT spawn prompt XML to stdout.
-
-    Args:
-        all_arguments: Command-line arguments.
-
-    Returns:
-        0 on success.
-    """
-    arguments = parse_arguments(all_arguments)
-    xml_output = emit_audit_prompt(
-        owner=arguments.owner,
-        repo=arguments.repo,
-        pr_number=arguments.pr_number,
-        loop=arguments.loop,
-        head_ref=arguments.head_ref,
-        base_ref=arguments.base_ref,
-        worktree_path=arguments.worktree_path,
-        run_temp_dir=arguments.run_temp_dir,
-        pr_body_text=read_pr_body_text(arguments.pr_body_file),
-        flavor=arguments.flavor,
-    )
-    sys.stdout.write(xml_output)
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main(sys.argv[1:]))

package/.agents/skills/_shared/pr-loop/scripts/build_converge_task_list.py

@@ -1,310 +0,0 @@
-#!/usr/bin/env python3
-"""``build_converge_task_list.py`` — ordered review tasks for a run.
-
-Step 1 of autoconverge / portable pr-converge: call this script. Do not invent
-tasks in prose. The final task is always all runnable code reviews CLEAN on
-the same HEAD.
-
-::
-
-    python build_converge_task_list.py \\
-        [--bugbot-down 0|1] [--copilot-down 0|1] \\
-        [--codex-down 0|1] [--codex-required 0|1]
-
-Stdout JSON::
-
-    {
-      "tasks": [...],
-      "runnable_review_ids": [...],
-      "skipped_review_ids": [...],
-      "final_task_id": "all_runnable_reviews_clean_same_head",
-      "done_when": "..."
-    }
-"""
-
-from __future__ import annotations
-
-import argparse
-import json
-import sys
-from pathlib import Path
-
-_self_dir = Path(__file__).resolve().parent
-if str(_self_dir) not in sys.path:
-    sys.path.insert(0, str(_self_dir))
-
-from select_converge_pacer import parse_bool_flag  # noqa: E402
-from skills_pr_loop_constants.converge_task_list_constants import (  # noqa: E402
-    CLI_BUGBOT_DOWN_FLAG,
-    CLI_CODEX_DOWN_FLAG,
-    CLI_CODEX_REQUIRED_FLAG,
-    CLI_COPILOT_DOWN_FLAG,
-    DONE_WHEN_TEXT,
-    EXIT_SUCCESS,
-    EXIT_USAGE_ERROR,
-    RESULT_KEY_DONE_WHEN,
-    RESULT_KEY_FINAL_TASK_ID,
-    RESULT_KEY_RUNNABLE_REVIEW_IDS,
-    RESULT_KEY_SKIPPED_REVIEW_IDS,
-    RESULT_KEY_TASKS,
-    SKIP_REASON_BUGBOT_DOWN,
-    SKIP_REASON_CODEX_DOWN,
-    SKIP_REASON_CODEX_NOT_REQUIRED,
-    SKIP_REASON_COPILOT_DOWN,
-    TASK_FIELD_ID,
-    TASK_FIELD_IS_RUNNABLE,
-    TASK_FIELD_KIND,
-    TASK_FIELD_SKIP_REASON,
-    TASK_FIELD_TITLE,
-    TASK_ID_ALL_CLEAN_SAME_HEAD,
-    TASK_ID_BUGBOT,
-    TASK_ID_BUGTEAM,
-    TASK_ID_CODE_REVIEW,
-    TASK_ID_CODEX,
-    TASK_ID_COPILOT,
-    TASK_KIND_FINAL,
-    TASK_KIND_REVIEW,
-    TASK_TITLE_ALL_CLEAN_SAME_HEAD,
-    TASK_TITLE_BUGBOT,
-    TASK_TITLE_BUGTEAM,
-    TASK_TITLE_CODE_REVIEW,
-    TASK_TITLE_CODEX,
-    TASK_TITLE_COPILOT,
-)
-
-
-def _review_task(
-    *,
-    task_id: str,
-    title: str,
-    is_runnable: bool,
-    skip_reason: str | None,
-) -> dict[str, object]:
-    task: dict[str, object] = {
-        TASK_FIELD_ID: task_id,
-        TASK_FIELD_TITLE: title,
-        TASK_FIELD_KIND: TASK_KIND_REVIEW,
-        TASK_FIELD_IS_RUNNABLE: is_runnable,
-    }
-    if skip_reason is not None:
-        task[TASK_FIELD_SKIP_REASON] = skip_reason
-    return task
-
-
-def _append_always_runnable_reviews(
-    all_tasks: list[dict[str, object]],
-) -> None:
-    all_tasks.append(
-        _review_task(
-            task_id=TASK_ID_CODE_REVIEW,
-            title=TASK_TITLE_CODE_REVIEW,
-            is_runnable=True,
-            skip_reason=None,
-        )
-    )
-    all_tasks.append(
-        _review_task(
-            task_id=TASK_ID_BUGTEAM,
-            title=TASK_TITLE_BUGTEAM,
-            is_runnable=True,
-            skip_reason=None,
-        )
-    )
-
-
-def _append_bugbot_task(
-    all_tasks: list[dict[str, object]],
-    *,
-    is_bugbot_down: bool,
-) -> None:
-    if is_bugbot_down:
-        all_tasks.append(
-            _review_task(
-                task_id=TASK_ID_BUGBOT,
-                title=TASK_TITLE_BUGBOT,
-                is_runnable=False,
-                skip_reason=SKIP_REASON_BUGBOT_DOWN,
-            )
-        )
-        return
-    all_tasks.append(
-        _review_task(
-            task_id=TASK_ID_BUGBOT,
-            title=TASK_TITLE_BUGBOT,
-            is_runnable=True,
-            skip_reason=None,
-        )
-    )
-
-
-def _append_copilot_task(
-    all_tasks: list[dict[str, object]],
-    *,
-    is_copilot_down: bool,
-) -> None:
-    if is_copilot_down:
-        all_tasks.append(
-            _review_task(
-                task_id=TASK_ID_COPILOT,
-                title=TASK_TITLE_COPILOT,
-                is_runnable=False,
-                skip_reason=SKIP_REASON_COPILOT_DOWN,
-            )
-        )
-        return
-    all_tasks.append(
-        _review_task(
-            task_id=TASK_ID_COPILOT,
-            title=TASK_TITLE_COPILOT,
-            is_runnable=True,
-            skip_reason=None,
-        )
-    )
-
-
-def _append_codex_task(
-    all_tasks: list[dict[str, object]],
-    *,
-    is_codex_down: bool,
-    is_codex_required: bool,
-) -> None:
-    if is_codex_down:
-        all_tasks.append(
-            _review_task(
-                task_id=TASK_ID_CODEX,
-                title=TASK_TITLE_CODEX,
-                is_runnable=False,
-                skip_reason=SKIP_REASON_CODEX_DOWN,
-            )
-        )
-        return
-    if not is_codex_required:
-        all_tasks.append(
-            _review_task(
-                task_id=TASK_ID_CODEX,
-                title=TASK_TITLE_CODEX,
-                is_runnable=False,
-                skip_reason=SKIP_REASON_CODEX_NOT_REQUIRED,
-            )
-        )
-        return
-    all_tasks.append(
-        _review_task(
-            task_id=TASK_ID_CODEX,
-            title=TASK_TITLE_CODEX,
-            is_runnable=True,
-            skip_reason=None,
-        )
-    )
-
-
-def _append_final_task(all_tasks: list[dict[str, object]]) -> None:
-    all_tasks.append(
-        {
-            TASK_FIELD_ID: TASK_ID_ALL_CLEAN_SAME_HEAD,
-            TASK_FIELD_TITLE: TASK_TITLE_ALL_CLEAN_SAME_HEAD,
-            TASK_FIELD_KIND: TASK_KIND_FINAL,
-            TASK_FIELD_IS_RUNNABLE: True,
-        }
-    )
-
-
-def _partition_review_ids(
-    all_tasks: list[dict[str, object]],
-) -> tuple[list[str], list[str]]:
-    all_runnable_review_ids = [
-        str(each_task[TASK_FIELD_ID])
-        for each_task in all_tasks
-        if each_task[TASK_FIELD_KIND] == TASK_KIND_REVIEW
-        and each_task[TASK_FIELD_IS_RUNNABLE] is True
-    ]
-    all_skipped_review_ids = [
-        str(each_task[TASK_FIELD_ID])
-        for each_task in all_tasks
-        if each_task[TASK_FIELD_KIND] == TASK_KIND_REVIEW
-        and each_task[TASK_FIELD_IS_RUNNABLE] is False
-    ]
-    return all_runnable_review_ids, all_skipped_review_ids
-
-
-def build_converge_task_list(
-    *,
-    is_bugbot_down: bool,
-    is_copilot_down: bool,
-    is_codex_down: bool,
-    is_codex_required: bool,
-) -> dict[str, object]:
-    """Return the ordered task list and done criterion for one converge run.
-
-    Args:
-        is_bugbot_down: Skip Bugbot as a runnable review.
-        is_copilot_down: Skip Copilot as a runnable review.
-        is_codex_down: Skip Codex even when usage would require it.
-        is_codex_required: Weekly usage / policy requires a Codex review.
-
-    Returns:
-        JSON-serializable control object with ``tasks`` and ``done_when``.
-    """
-    all_tasks: list[dict[str, object]] = []
-    _append_always_runnable_reviews(all_tasks)
-    _append_bugbot_task(all_tasks, is_bugbot_down=is_bugbot_down)
-    _append_copilot_task(all_tasks, is_copilot_down=is_copilot_down)
-    _append_codex_task(
-        all_tasks,
-        is_codex_down=is_codex_down,
-        is_codex_required=is_codex_required,
-    )
-    _append_final_task(all_tasks)
-    all_runnable_review_ids, all_skipped_review_ids = _partition_review_ids(
-        all_tasks
-    )
-    return {
-        RESULT_KEY_TASKS: all_tasks,
-        RESULT_KEY_RUNNABLE_REVIEW_IDS: all_runnable_review_ids,
-        RESULT_KEY_SKIPPED_REVIEW_IDS: all_skipped_review_ids,
-        RESULT_KEY_FINAL_TASK_ID: TASK_ID_ALL_CLEAN_SAME_HEAD,
-        RESULT_KEY_DONE_WHEN: DONE_WHEN_TEXT,
-    }
-
-
-def build_argument_parser() -> argparse.ArgumentParser:
-    """Build the CLI parser for ``build_converge_task_list``.
-
-    Returns:
-        Configured argument parser.
-    """
-    parser = argparse.ArgumentParser(description="build_converge_task_list")
-    parser.add_argument(CLI_BUGBOT_DOWN_FLAG, default="0")
-    parser.add_argument(CLI_COPILOT_DOWN_FLAG, default="0")
-    parser.add_argument(CLI_CODEX_DOWN_FLAG, default="0")
-    parser.add_argument(CLI_CODEX_REQUIRED_FLAG, default="0")
-    return parser
-
-
-def main(all_argv: list[str]) -> int:
-    """CLI entry: print one task-list JSON object on stdout.
-
-    Args:
-        all_argv: Argument vector without program name.
-
-    Returns:
-        Process exit code.
-    """
-    parser = build_argument_parser()
-    parsed_arguments = parser.parse_args(all_argv)
-    try:
-        task_list_payload = build_converge_task_list(
-            is_bugbot_down=parse_bool_flag(parsed_arguments.bugbot_down),
-            is_copilot_down=parse_bool_flag(parsed_arguments.copilot_down),
-            is_codex_down=parse_bool_flag(parsed_arguments.codex_down),
-            is_codex_required=parse_bool_flag(parsed_arguments.codex_required),
-        )
-    except ValueError as validation_error:
-        print(str(validation_error), file=sys.stderr)
-        return EXIT_USAGE_ERROR
-    print(json.dumps(task_list_payload, sort_keys=True))
-    return EXIT_SUCCESS
-
-
-if __name__ == "__main__":
-    raise SystemExit(main(sys.argv[1:]))