build: 部署编排与打包脚本（deploy/scripts/Docker）
This commit is contained in:
@@ -0,0 +1,104 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
# pylint: disable=wrong-import-position
|
||||
"""CI check entry point: evaluate real-behavior-proof for the current PR.
|
||||
|
||||
Reads PR metadata from the GitHub Actions event payload, runs the policy
|
||||
check, and exits non-zero if the PR is missing required context/evidence.
|
||||
|
||||
Environment variables:
|
||||
GITHUB_TOKEN — GitHub token with ``pull-requests: read``
|
||||
PR_NUMBER — Pull request number (auto-detected from event)
|
||||
PR_BODY — PR body (auto-detected from event)
|
||||
PR_AUTHOR_ASSOC — Author association (auto-detected)
|
||||
PR_AUTHOR_TYPE — Author type (auto-detected)
|
||||
PR_LABELS — Comma-separated label names (auto-detected)
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import os
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
# Add scripts/ to path so we can import the policy module.
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parent))
|
||||
|
||||
from real_behavior_proof_policy import ( # noqa: E402
|
||||
ProofStatus,
|
||||
evaluate_pull_request_context,
|
||||
)
|
||||
|
||||
|
||||
def _load_event() -> dict:
|
||||
"""Load the GitHub Actions event payload."""
|
||||
event_path = os.environ.get("GITHUB_EVENT_PATH", "")
|
||||
if event_path and Path(event_path).is_file():
|
||||
return json.loads(Path(event_path).read_text("utf-8"))
|
||||
return {}
|
||||
|
||||
|
||||
def main() -> int:
|
||||
event = _load_event()
|
||||
pr = event.get("pull_request") or {}
|
||||
|
||||
body: str = pr.get("body") or os.environ.get("PR_BODY", "")
|
||||
author_association: str = pr.get("author_association") or os.environ.get(
|
||||
"PR_AUTHOR_ASSOC",
|
||||
"CONTRIBUTOR",
|
||||
)
|
||||
author_type = (pr.get("user") or {}).get("type") or os.environ.get(
|
||||
"PR_AUTHOR_TYPE",
|
||||
"User",
|
||||
)
|
||||
labels = [lbl.get("name", "") for lbl in (pr.get("labels") or [])] or [
|
||||
name.strip()
|
||||
for name in os.environ.get("PR_LABELS", "").split(",")
|
||||
if name.strip()
|
||||
]
|
||||
|
||||
pr_number = pr.get("number") or os.environ.get("PR_NUMBER", "?")
|
||||
pr_url = pr.get("html_url", "")
|
||||
|
||||
print(f"Checking real-behavior-proof for PR #{pr_number}")
|
||||
print(f" author_association: {author_association}")
|
||||
print(f" author_type: {author_type}")
|
||||
print(f" labels: {labels}")
|
||||
print(f" body length: {len(body)} chars")
|
||||
|
||||
evaluation = evaluate_pull_request_context(
|
||||
body=body,
|
||||
author_association=author_association,
|
||||
author_type=author_type,
|
||||
labels=labels,
|
||||
)
|
||||
|
||||
print(f" status: {evaluation.status.value}")
|
||||
|
||||
if evaluation.status == ProofStatus.SKIPPED:
|
||||
print(" → SKIPPED (maintainer/bot/override)")
|
||||
return 0
|
||||
|
||||
if evaluation.status == ProofStatus.PASSED:
|
||||
print(" → PASSED ✓")
|
||||
return 0
|
||||
|
||||
# MISSING
|
||||
print(f" → MISSING sections: {evaluation.missing_sections}")
|
||||
print()
|
||||
print("This PR is from an external contributor and is missing required")
|
||||
print("context or evidence. Please update the PR body to include:")
|
||||
print()
|
||||
for section in evaluation.missing_sections:
|
||||
print(f" ## {section}")
|
||||
print(" [Describe/show real behavior — not template comments]")
|
||||
print()
|
||||
print("See the PR template for guidance. Template HTML comments do NOT")
|
||||
print("count as authored content.")
|
||||
print()
|
||||
print(f"PR: {pr_url}")
|
||||
return 1
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main())
|
||||
@@ -0,0 +1,223 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
"""Real behavior proof policy for QwenPaw PR checks.
|
||||
|
||||
Ported from openclaw's ``real-behavior-proof-policy.mjs``. Parses a PR
|
||||
body and determines whether an **external contributor** has provided the
|
||||
two required sections:
|
||||
|
||||
1. **What Problem This Solves** — a concrete user/product/operational
|
||||
problem description (template comments do not count).
|
||||
2. **Evidence** — real validation evidence: screenshots, terminal
|
||||
transcripts, CI artifact links, test output, etc.
|
||||
|
||||
Maintainer / bot PRs are auto-skipped. The ``proof: override`` label
|
||||
bypasses the check.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import re
|
||||
from dataclasses import dataclass, field
|
||||
from enum import Enum
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Labels
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
NEEDS_PR_CONTEXT_LABEL = "triage: needs-pr-context"
|
||||
PROOF_OVERRIDE_LABEL = "proof: override"
|
||||
PROOF_SUFFICIENT_LABEL = "proof: sufficient"
|
||||
|
||||
# Authors with these associations skip the check entirely.
|
||||
PRIVILEGED_ASSOCIATIONS = frozenset({"OWNER", "MEMBER", "COLLABORATOR"})
|
||||
|
||||
# Values that count as "not provided" when they are the *only* content in
|
||||
# a section body.
|
||||
_MISSING_VALUE_RE = re.compile(
|
||||
r"^(?:n/?a|none|not applicable|tbd|todo|unknown|unsure|"
|
||||
r"none provided|no evidence|not tested|untested|"
|
||||
r"did not test|didn't test|could not test|couldn't test|"
|
||||
r"-|(?:-{3,}|\*{3,}|_{3,})|\[[^\]]*\])\.?$",
|
||||
re.IGNORECASE,
|
||||
)
|
||||
|
||||
_SECTION_RE = re.compile(r"^#{1,6}\s+(.+?)\s*$", re.MULTILINE)
|
||||
|
||||
|
||||
class ProofStatus(str, Enum):
|
||||
PASSED = "passed"
|
||||
MISSING = "missing"
|
||||
SKIPPED = "skipped"
|
||||
|
||||
|
||||
@dataclass
|
||||
class ProofEvaluation:
|
||||
status: ProofStatus
|
||||
missing_sections: list[str] = field(default_factory=list)
|
||||
labels: list[str] = field(default_factory=list)
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Helpers
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
|
||||
def _normalize_line_endings(text: str = "") -> str:
|
||||
return text.replace("\r\n", "\n").replace("\r", "\n")
|
||||
|
||||
|
||||
def _mask_html_comments(text: str) -> str:
|
||||
"""Replace HTML comment content with spaces so commented-out template
|
||||
text does not count as authored content."""
|
||||
return re.sub(
|
||||
r"<!--.*?-->",
|
||||
lambda m: " " * len(m.group(0)),
|
||||
text,
|
||||
flags=re.DOTALL,
|
||||
)
|
||||
|
||||
|
||||
def _strip_code_fences(text: str) -> str:
|
||||
"""Remove fenced code blocks so headings/copy-pasted template text
|
||||
inside them do not trick the section parser."""
|
||||
return re.sub(r"```[^\n]*\n.*?```", "", text, flags=re.DOTALL)
|
||||
|
||||
|
||||
def _extract_sections(body: str) -> dict[str, str]:
|
||||
"""Split a PR body into a ``{heading: body}`` mapping."""
|
||||
body = _normalize_line_endings(body)
|
||||
body = _mask_html_comments(body)
|
||||
body = _strip_code_fences(body)
|
||||
|
||||
sections: dict[str, str] = {}
|
||||
matches = list(_SECTION_RE.finditer(body))
|
||||
for i, match in enumerate(matches):
|
||||
heading = match.group(1).strip().lower()
|
||||
start = match.end()
|
||||
end = matches[i + 1].start() if i + 1 < len(matches) else len(body)
|
||||
section_body = body[start:end].strip()
|
||||
sections[heading] = section_body
|
||||
return sections
|
||||
|
||||
|
||||
def _has_real_content(text: str) -> bool:
|
||||
"""Return True if *text* has substantive authored content (not just
|
||||
template placeholders, separators, or ``None``-like values)."""
|
||||
text = text.strip()
|
||||
if not text:
|
||||
return False
|
||||
if _MISSING_VALUE_RE.match(text):
|
||||
return False
|
||||
# Must have at least one alphanumeric character.
|
||||
if not re.search(r"[A-Za-z0-9]", text):
|
||||
return False
|
||||
return True
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Section name aliases (support legacy + current template)
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
_PROBLEM_ALIASES = [
|
||||
"what problem this solves",
|
||||
"behavior or issue addressed",
|
||||
"issue addressed",
|
||||
"behavior addressed",
|
||||
"description",
|
||||
]
|
||||
|
||||
_EVIDENCE_ALIASES = [
|
||||
"evidence",
|
||||
"evidence after fix",
|
||||
"after-fix evidence",
|
||||
"evidence link or embedded proof",
|
||||
"local verification evidence",
|
||||
"testing",
|
||||
"how to test these changes",
|
||||
]
|
||||
|
||||
|
||||
def _find_section(sections: dict[str, str], aliases: list[str]) -> str | None:
|
||||
for alias in aliases:
|
||||
for heading, body in sections.items():
|
||||
if alias in heading:
|
||||
return body
|
||||
return None
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Public API
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
|
||||
def evaluate_pull_request_context(
|
||||
*,
|
||||
body: str,
|
||||
author_association: str = "CONTRIBUTOR",
|
||||
author_type: str = "User",
|
||||
labels: list[str] | None = None,
|
||||
) -> ProofEvaluation:
|
||||
"""Evaluate whether a PR has the required context and evidence.
|
||||
|
||||
Parameters
|
||||
----------
|
||||
body
|
||||
The PR body text (markdown).
|
||||
author_association
|
||||
The GitHub ``author_association`` field — ``OWNER``, ``MEMBER``,
|
||||
``COLLABORATOR``, ``CONTRIBUTOR``, ``NONE``, etc.
|
||||
author_type
|
||||
The GitHub user ``type`` — ``User``, ``Bot``, etc.
|
||||
labels
|
||||
List of label names on the PR.
|
||||
|
||||
Returns
|
||||
-------
|
||||
ProofEvaluation
|
||||
``status=PASSED`` if both sections are present with real content,
|
||||
``status=MISSING`` if either is absent or empty,
|
||||
``status=SKIPPED`` for maintainer/bot PRs.
|
||||
"""
|
||||
labels = labels or []
|
||||
|
||||
# --- Skip rules -------------------------------------------------------
|
||||
if author_type == "Bot":
|
||||
return ProofEvaluation(status=ProofStatus.SKIPPED)
|
||||
|
||||
if author_association in PRIVILEGED_ASSOCIATIONS:
|
||||
return ProofEvaluation(status=ProofStatus.SKIPPED)
|
||||
|
||||
# The override label lets a maintainer force-skip — but it does NOT
|
||||
# auto-pass; the PR still needs context unless a maintainer explicitly
|
||||
# marks it proof-sufficient.
|
||||
if PROOF_SUFFICIENT_LABEL in labels:
|
||||
return ProofEvaluation(status=ProofStatus.SKIPPED)
|
||||
|
||||
# --- Parse body -------------------------------------------------------
|
||||
sections = _extract_sections(body)
|
||||
|
||||
missing: list[str] = []
|
||||
|
||||
problem_text = _find_section(sections, _PROBLEM_ALIASES)
|
||||
if problem_text is None or not _has_real_content(problem_text):
|
||||
missing.append("What Problem This Solves")
|
||||
|
||||
evidence_text = _find_section(sections, _EVIDENCE_ALIASES)
|
||||
if evidence_text is None or not _has_real_content(evidence_text):
|
||||
missing.append("Evidence")
|
||||
|
||||
if missing:
|
||||
return ProofEvaluation(
|
||||
status=ProofStatus.MISSING,
|
||||
missing_sections=missing,
|
||||
labels=[NEEDS_PR_CONTEXT_LABEL],
|
||||
)
|
||||
|
||||
return ProofEvaluation(
|
||||
status=ProofStatus.PASSED,
|
||||
labels=[PROOF_SUFFICIENT_LABEL],
|
||||
)
|
||||
|
||||
|
||||
def labels_for_pull_request_context(evaluation: ProofEvaluation) -> list[str]:
|
||||
"""Convenience: return the labels to add/remove for a given evaluation."""
|
||||
return evaluation.labels
|
||||
Reference in New Issue
Block a user