Skip to content

jeremylongshore/tons-of-skills-marketplace / plugins/community/contributing-clanker/skills/contribute-prepare

contribute-prepare

Verified

Prepare an OSS contribution locally after a read-only contribution audit. Creates explicitly scoped candidate records, repository dossiers, worktrees, test evidence, and gate results, but never publishes to GitHub. Use when the user has selected an issue and asks to set up, research, implement, test, or draft the contribution. Trigger with "/contribute-prepare" or "prepare this contribution locally".

FileKindSize
SKILL.mdskill md5.1 KB
agents/draft-writer.mdmarkdown2.0 KB
agents/repo-analyzer.mdmarkdown3.1 KB
agents/researcher.mdmarkdown10.5 KB
agents/scout.mdmarkdown7.5 KB
agents/test-runner.mdmarkdown3.5 KB
assets/claim-template.mdmarkdown714 B
assets/evidence-template.mdmarkdown532 B
assets/pr-template.mdmarkdown890 B
references/candidate-file-format.mdmarkdown9.3 KB
references/workflow-guide.mdmarkdown3.9 KB
scripts/audit-overrides.shexecutablescript7.3 KB
scripts/catalog-coverage.shexecutablescript4.0 KB
scripts/check.shexecutablescript1.1 KB
scripts/gate-runner.shexecutablescript8.9 KB
scripts/gates/a01-already-assigned.shexecutablescript1.1 KB
scripts/gates/a02-already-shipped.shexecutablescript1.3 KB
scripts/gates/a03-duplicate-flagged.shexecutablescript851 B
scripts/gates/a04-issue-age.shexecutablescript3.8 KB
scripts/gates/a05-issue-still-open.shexecutablescript1.6 KB
scripts/gates/a06-claim-etiquette-required.shexecutablescript1.6 KB
scripts/gates/a09-mention-routing.shexecutablescript2.1 KB
scripts/gates/b01-base-branch.shexecutablescript969 B
scripts/gates/b02-branch-naming.shexecutablescript1.0 KB
scripts/gates/b03-clone-fresh.shexecutablescript1.0 KB
scripts/gates/b05-dco-signoff.shexecutablescript1.5 KB
scripts/gates/b06-commit-format.shexecutablescript1.4 KB
scripts/gates/b07-scope-files.shexecutablescript2.1 KB
scripts/gates/b12-new-deps.shexecutablescript1.7 KB
scripts/gates/b14-local-checks.shexecutablescript1.7 KB
scripts/gates/b16-local-check-allowlist.shexecutablescript1.8 KB
scripts/gates/c01-draft-first.shexecutablescript902 B
scripts/gates/c02-pr-title-format.shexecutablescript1.2 KB
scripts/gates/c03-pr-body-sections.shexecutablescript2.0 KB
scripts/gates/c04-ui-screenshots.shexecutablescript1.6 KB
scripts/gates/c05-test-evidence.shexecutablescript1.4 KB
scripts/gates/c07-coauthor-banned.shexecutablescript1.2 KB
scripts/gates/c09-issue-link.shexecutablescript1.5 KB
scripts/gates/c11-no-force-push.shexecutablescript1.3 KB
scripts/gates/c12-ci-green.shexecutablescript1.2 KB
scripts/gates/c13-bots-passed.shexecutablescript2.1 KB
scripts/gates/c16-no-self-merge.shexecutablescript914 B
scripts/gates/c19-body-claim-vs-diff.shexecutablescript2.9 KB
scripts/gates/d02-no-ai-bug-reports.shexecutablescript1.4 KB
scripts/gates/d03-no-ai-pr-reviews.shexecutablescript1.1 KB
scripts/gates/d05-no-reopen.shexecutablescript1.1 KB
scripts/gates/e02-ai-strike-track.shexecutablescript2.7 KB
scripts/gates/e04-fork-target.shexecutablescript1.5 KB
scripts/gates/f01-license-compat.shexecutablescript3.5 KB
scripts/gates/f03-fixtures-clean.shexecutablescript1.2 KB
scripts/gates/f04-override-disclosure.shexecutablescript2.4 KB
scripts/gates/g01-no-vendored-edits.shexecutablescript1.9 KB
scripts/gates/g02-protected-paths.shexecutablescript1.2 KB
scripts/gates/g03-no-changelog-edits.shexecutablescript1.4 KB
scripts/gates/g04-no-version-bump.shexecutablescript1.4 KB
scripts/gates/g06-override-rate-limit.shexecutablescript1.5 KB
scripts/gates/lib/preamble.shexecutablescript4.8 KB
scripts/lint-candidate.shexecutablescript5.1 KB
scripts/researcher-build.shexecutablescript17.6 KB
scripts/researcher-refresh.pyscript4.9 KB
scripts/setup.shexecutablescript1.7 KB
scripts/test-known-traps.shexecutablescript5.4 KB
scripts/test-override-audit.shexecutablescript3.5 KB
scripts/test-plug-in.shexecutablescript4.0 KB
scripts/test-scout-refresh.shexecutablescript4.9 KB
scripts/test-stale-dossier-refresh.shexecutablescript3.7 KB
scripts/transition.shexecutablescript10.3 KB

scripts/test-override-audit.sh

View on GitHub
#!/usr/bin/env bash
# test-override-audit.sh — regression test for the override audit trail.
#
# Promise: every `transition.sh --override-gate <ID> "reason"` call
#   1. appends a `gate_override` event to $CONTRIBUTE_STATE_DIR/log.jsonl
#   2. writes the override into the candidate's frontmatter overrides: array
#   3. allows the transition to proceed (BLOCK gate becomes effective-PASS)
#
# This validates the audit trail that lets engineers see WHY a gate was bypassed.
#
# Usage: test-override-audit.sh [--verbose]
# Exit 0: all assertions hold. Exit 1: any failure.

set -uo pipefail

VERBOSE="${1:-}"
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
TMPDIR=$(/usr/bin/mktemp -d)
trap 'rm -rf "$TMPDIR"' EXIT
export CONTRIBUTE_STATE_DIR="$TMPDIR/state"
export CONTRIBUTE_WORKSPACE_DIR="$TMPDIR/workspace"
mkdir -p "$CONTRIBUTE_STATE_DIR/user-gates" "$CONTRIBUTE_WORKSPACE_DIR"
touch "$CONTRIBUTE_STATE_DIR/log.jsonl"
SYS="$CONTRIBUTE_STATE_DIR"

PASS=0
FAIL=0
red()    { /usr/bin/printf '\033[31m%s\033[0m' "$1"; }
green()  { /usr/bin/printf '\033[32m%s\033[0m' "$1"; }

assert() {
  local name="$1" expr="$2"
  /usr/bin/printf '  %-60s ' "$name"
  if eval "$expr" >/dev/null 2>&1; then
    green "PASS"; /usr/bin/echo
    PASS=$((PASS + 1))
  else
    red "FAIL"; /usr/bin/echo
    [[ "$VERBOSE" == "--verbose" ]] && /usr/bin/printf '    expr: %s\n' "$expr" >&2
    FAIL=$((FAIL + 1))
  fi
}

# Build a synthetic candidate (closed issue, will trigger A05 BLOCK)
SYNTH="$TMPDIR/synth-override.md"
/usr/bin/cat > "$SYNTH" <<'EOF'
---
discovered_at: 2026-05-03T00:00:00Z
repo: lingdojo/kana-dojo
issue_number: 15441
issue_url: https://github.com/lingdojo/kana-dojo/issues/15441
star_tier: mainstream
star_count: 2231
repo_lang: TypeScript
competing_prs: 0
primary_label: bug
scout_score: 0.5
status: open
last_refreshed: 2026-05-03T00:00:00Z
---

# synthetic — override audit test
EOF

LOG_BEFORE_LINES=$(/usr/bin/wc -l < "$SYS/log.jsonl" 2>/dev/null || /usr/bin/echo "0")

/usr/bin/printf '\n=== override audit regression ===\n\n'

# --- TEST 1: dry-run override pre-records WITHOUT mutating candidate ---
"$SCRIPT_DIR/transition.sh" "shortlist→claimed" "$SYNTH" \
  --dry-run \
  --override-gate A05 "regression test: dry-run should not write" \
  >/dev/null 2>&1

assert "1. dry-run override does NOT write 'overrides:' to candidate" \
  '! /usr/bin/grep -q "^overrides:" "$SYNTH"'

# --- TEST 2: real override (no --dry-run) writes to candidate frontmatter ---
"$SCRIPT_DIR/transition.sh" "shortlist→claimed" "$SYNTH" \
  --override-gate A05 "test 2: real override audit" \
  >/dev/null 2>&1 || true   # gate block exit-code may be 0 or 1; we don't care

assert "2. real override DOES write 'overrides:' to candidate" \
  '/usr/bin/grep -q "^overrides:" "$SYNTH"'

assert "3. override entry contains gate ID A05" \
  '/usr/bin/grep -q "gate: A05" "$SYNTH"'

assert "4. override entry contains the reason text" \
  '/usr/bin/grep -q "test 2: real override audit" "$SYNTH"'

# --- TEST 3: log.jsonl gets gate_override event ---
LOG_AFTER_LINES=$(/usr/bin/wc -l < "$SYS/log.jsonl" 2>/dev/null || /usr/bin/echo "0")

assert "5. log.jsonl grew (new event lines appended)" \
  '[[ "$LOG_AFTER_LINES" -gt "$LOG_BEFORE_LINES" ]]'

assert "6. log.jsonl contains a gate_override event for A05" \
  '/usr/bin/tail -20 "$SYS/log.jsonl" | /usr/bin/grep -q "\"event\":\"gate_override\".*\"gate\":\"A05\""'

/usr/bin/echo
/usr/bin/printf '=== summary: %s passed · %s failed ===\n\n' \
  "$(green "$PASS")" "$([ "$FAIL" -gt 0 ] && red "$FAIL" || /usr/bin/echo 0)"

[[ "$FAIL" -eq 0 ]] || exit 1
exit 0
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 196kUpdated Claude CodeCodexVerifiedInstall