@boyingliu01/xp-gate 0.8.1 → 0.8.4

package/adapters/plugins/whalecloud-java/rules/style/wc-style-002.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-002
+name: 规范for循环中计数器常量使用
+severity: error  # error=阻断, warning=警告
+source: J000065
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  规范for循环中计数器常量使用
+
+  对应浩鲸规范 J000065。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "Magic number in for loop"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-003.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-003
+name: 避免一个语句中给多个变量赋值
+severity: error  # error=阻断, warning=警告
+source: J000066
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  避免一个语句中给多个变量赋值
+
+  对应浩鲸规范 J000066。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "Multiple assignment readability"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-004.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-004
+name: 不使用float/double进行精确数值计算
+severity: error  # error=阻断, warning=警告
+source: J000070
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  不使用float/double进行精确数值计算
+
+  对应浩鲸规范 J000070。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "PMD:AvoidDecimalLiteralsInBigDecimalConstructor"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-005.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-005
+name: 调用String.substring时先进行长度判断
+severity: error  # error=阻断, warning=警告
+source: J000073
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  调用String.substring时先进行长度判断
+
+  对应浩鲸规范 J000073。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "IndexOutOfBoundsException prevention"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-006.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-006
+name: 数据库表数值类型主键定义成Long
+severity: error  # error=阻断, warning=警告
+source: J000074
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  数据库表数值类型主键定义成Long
+
+  对应浩鲸规范 J000074。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "Integer overflow prevention"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-007.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-007
+name: 不能使用过时的类或方法
+severity: error  # error=阻断, warning=警告
+source: J000083
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  不能使用过时的类或方法
+
+  对应浩鲸规范 J000083。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "PMD:UseCorrectExceptionLogging"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-008.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-008
+name: 禁止使用BigDecimal(double)构造方法
+severity: error  # error=阻断, warning=警告
+source: J000086
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  禁止使用BigDecimal(double)构造方法
+
+  对应浩鲸规范 J000086。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "PMD:AvoidDecimalLiteralsInBigDecimalConstructor"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-009.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-009
+name: POJO类不要设定属性默认值
+severity: error  # error=阻断, warning=警告
+source: J000088
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  POJO类不要设定属性默认值
+
+  对应浩鲸规范 J000088。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "Default value anti-pattern"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-010.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-010
+name: 禁止POJO类同时存在isXxx和getXxx
+severity: error  # error=阻断, warning=警告
+source: J000091
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  禁止POJO类同时存在isXxx和getXxx
+
+  对应浩鲸规范 J000091。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "Boolean property naming"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-011.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-011
+name: 避免重复创建字符串对象
+severity: error  # error=阻断, warning=警告
+source: J000123
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  避免重复创建字符串对象
+
+  对应浩鲸规范 J000123。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "String literal reuse"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-012.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-012
+name: 避免用对象访问类的静态变量和方法
+severity: error  # error=阻断, warning=警告
+source: J000125
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  避免用对象访问类的静态变量和方法
+
+  对应浩鲸规范 J000125。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "Static access via instance"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-013.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-013
+name: 避免定义未使用的局部变量/参数/私有方法
+severity: error  # error=阻断, warning=警告
+source: J000097
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  避免定义未使用的局部变量/参数/私有方法
+
+  对应浩鲸规范 J000097。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "Dead code detection"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-014.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-014
+name: 谨慎调用静态的Calendar/DateFormat
+severity: error  # error=阻断, warning=警告
+source: J000100
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  谨慎调用静态的Calendar/DateFormat
+
+  对应浩鲸规范 J000100。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "SpotBugs:STCAL_INVOKE_ON_STATIC_*"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-015.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-015
+name: 在类型转换前进行数据类型检测
+severity: error  # error=阻断, warning=警告
+source: J000101
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  在类型转换前进行数据类型检测
+
+  对应浩鲸规范 J000101。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "ClassCastException prevention"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-016.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-016
+name: 确保SQL拼装时查询条件有效性
+severity: error  # error=阻断, warning=警告
+source: J000112
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  确保SQL拼装时查询条件有效性
+
+  对应浩鲸规范 J000112。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "SQL injection prevention"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-017.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-017
+name: 日期格式化年份统一使用小写y
+severity: error  # error=阻断, warning=警告
+source: J000063
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  日期格式化年份统一使用小写y
+
+  对应浩鲸规范 J000063。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "yyyy vs YYYY confusion"

package/adapters/plugins/whalecloud-java/rules/style/wc-style-018.yml

@@ -0,0 +1,17 @@
+---
+id: WC-STYLE-018
+name: 避免变量在使用前被另一个赋值覆盖
+severity: error  # error=阻断, warning=警告
+source: J000105
+tool: auto  # auto-manual-auto: detected by tool / manual check / AST-grep
+category: wc-style
+description: |
+  避免变量在使用前被另一个赋值覆盖
+
+  对应浩鲸规范 J000105。
+
+check:
+  type: ast-grep  # ast-grep / pmd-custom / spotbugs / checkstyle / manual
+  pattern: TODO
+
+notes: "Variable shadowing/overwrite"

package/adapters/plugins/whalecloud-java/scripts/install-gradle-whalecloud.sh

@@ -0,0 +1,97 @@
+#!/bin/bash
+# Install WhaleCloud Java Coding Standards into a Gradle project.
+# Usage: bash scripts/install-gradle-whalecloud.sh [project_root]
+set -e
+
+PLUGIN_DIR="$(cd "$(dirname "$0")"/.. && pwd)"
+PROJECT_ROOT="${1:-.}"
+
+cd "$PROJECT_ROOT"
+
+if [ ! -f "build.gradle" ] && [ ! -f "build.gradle.kts" ]; then
+  echo "❌ No build.gradle or build.gradle.kts found in $(pwd)"
+  exit 1
+fi
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "   XP-Gate: Installing WhaleCloud Java Coding Standards"
+echo "   for Gradle project"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+GRADLE_FILE="build.gradle"
+[ -f "build.gradle.kts" ] && GRADLE_FILE="build.gradle.kts"
+
+if grep -q 'XP-GateWhalecloudCheck\|whalecloud-ruleset' "$GRADLE_FILE"; then
+  echo "✅ WhaleCloud standard already configured in $GRADLE_FILE"
+  echo ""
+  echo "To run: ./gradlew XP-GateWhalecloudCheck"
+  exit 0
+fi
+
+echo "Installing into $GRADLE_FILE..."
+
+cat >> "$GRADLE_FILE" << 'APPEND'
+
+// ─── XP-Gate: WhaleCloud Java Coding Standards ───
+plugins {
+    id 'pmd'
+    id 'checkstyle'
+    id 'com.github.spotbugs' version '5.2.5'
+}
+
+pmd {
+    consoleOutput = true
+    toolVersion = '7.7.0'
+    ruleSetFiles = files('config/pmd/whalecloud-ruleset.xml')
+    ruleSets = [
+        '/rulesets/java/ali-comment.xml',
+        '/rulesets/java/ali-concurrent.xml',
+        '/rulesets/java/ali-constant.xml',
+        '/rulesets/java/ali-exception.xml',
+        '/rulesets/java/ali-flowcontrol.xml',
+        '/rulesets/java/ali-naming.xml',
+        '/rulesets/java/ali-oop.xml',
+        '/rulesets/java/ali-orm.xml',
+        '/rulesets/java/ali-other.xml',
+        '/rulesets/java/ali-set.xml'
+    ]
+    sourceSets = [sourceSets.main, sourceSets.test]
+}
+
+checkstyle {
+    toolVersion = '10.21.3'
+    configFile = file('config/checkstyle/whalecloud-checkstyle.xml')
+    sourceSets = [sourceSets.main, sourceSets.test]
+}
+
+spotbugs {
+    toolVersion = '4.7.3'
+    includeFilter = file('config/spotbugs/whalecloud-spotbugs.xml')
+    effort = 'max'
+    reportLevel = 'low'
+}
+
+dependencies {
+    spotbugsPlugins 'com.h3xstream.findsecbugs:findsecbugs-plugin:1.12.0'
+}
+
+task XP-GateWhalecloudCheck {
+    description = 'Run WhaleCloud Java coding standard checks'
+    group = 'Verification'
+    dependsOn 'pmdMain', 'pmdTest', 'checkstyleMain', 'checkstyleTest', 'spotbugsMain'
+}
+APPEND
+
+echo ""
+echo "✅ WhaleCloud standard installed!"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "   Usage"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "  # Run WhaleCloud quality checks:"
+echo "  ./gradlew XP-GateWhalecloudCheck"
+echo ""
+echo "  # This integrates into XP-Gate pre-commit Gate 1"
+echo ""

package/adapters/plugins/whalecloud-java/scripts/install-maven-whalecloud.sh

@@ -0,0 +1,201 @@
+#!/bin/bash
+# Install WhaleCloud Java Coding Standards into a Maven project.
+# Usage: bash scripts/install-maven-whalecloud.sh [project_root]
+#
+# This script:
+# 1. Detects if pom.xml exists
+# 2. Installs whalecloud config files (PMD/CheckStyle/SpotBugs rulesets)
+# 3. Merges xp-gate-whalecloud-java profile into pom.xml
+# 4. Outputs usage instructions
+
+set -e
+
+PLUGIN_DIR="$(cd "$(dirname "$0")"/.. && pwd)"
+PROJECT_ROOT="${1:-.}"
+
+cd "$PROJECT_ROOT"
+
+if [ ! -f "pom.xml" ]; then
+  echo "❌ No pom.xml found in $(pwd)"
+  echo "This script requires a Maven project."
+  exit 1
+fi
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "   XP-Gate: Installing WhaleCloud Java Coding Standards"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "This adds 106 rules (74 mandatory + 32 recommended) on"
+echo "top of p3c-pmd baseline (54 Alibaba rules)."
+echo ""
+
+# Step 1: Install config files
+CONFIG_DIR="config"
+mkdir -p "$CONFIG_DIR/pmd" "$CONFIG_DIR/checkstyle" "$CONFIG_DIR/spotbugs"
+
+echo "Step 1: Installing rule configuration files..."
+
+# PMD ruleset
+if [ -f "$CONFIG_DIR/pmd/whalecloud-ruleset.xml" ]; then
+  echo "  ✅ config/pmd/whalecloud-ruleset.xml already exists"
+else
+  cat > "$CONFIG_DIR/pmd/whalecloud-ruleset.xml" << 'RULESET'
+<?xml version="1.0"?>
+<ruleset name="WhaleCloud Java Rules"
+    xmlns="http://pmd.sourceforge.net/ruleset/2.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://pmd.sourceforge.net/ruleset/2.0.0 https://pmd.sourceforge.io/ruleset_2_0_0.xsd">
+
+  <description>WhaleCloud Java Coding Standards — Overlay Rules</description>
+
+  <!-- Collection: J000005 toArray(T[]) -->
+  <rule ref="category/java/bestpractices.xml/ArrayIsStoredDirectly"/>
+
+  <!-- Exception: J000042 Empty catch block -->
+  <rule ref="category/java/errorpractices.xml/EmptyCatchBlock"/>
+  <!-- Exception: J000044 Return from finally -->
+  <rule ref="category/java/errorpractices.xml/AvoidReturningFromFinallyBlock"/>
+
+  <!-- Style: J000070 BigDecimal double constructor -->
+  <rule ref="category/java/errorpractices.xml/AvoidDecimalLiteralsInBigDecimalConstructor"/>
+
+  <!-- Logging: J000053 Logger format -->
+  <rule ref="category/java/bestpractices.xml/GuardLogStatement"/>
+
+  <!-- Resource: J000108 System.gc() -->
+  <rule ref="category/java/errorpractices.xml/DoNotCallGarbageCollectionExplicitly"/>
+
+  <!-- Style: J000100 Static Calendar/DateFormat -->
+  <rule ref="category/java/multithreading.xml/NonThreadSafeProperty"/>
+
+  <!-- Performance: J000124 Pattern compilation -->
+  <rule ref="category/java/performance.xml/AvoidInstanceofChecksInCatchClause"/>
+
+  <!-- Security: J000078 SQL injection -->
+  <rule ref="category/java/security.xml/MethodRequiresCheck"/>
+
+  <!-- TODO: Add custom rules for J-rules not covered by standard PMD rulesets -->
+  <!-- Custom rules via XPath will be added here as the plugin matures -->
+
+</ruleset>
+RULESET
+  echo "  ✅ Created config/pmd/whalecloud-ruleset.xml"
+fi
+
+# CheckStyle configuration
+if [ -f "$CONFIG_DIR/checkstyle/whalecloud-checkstyle.xml" ]; then
+  echo "  ✅ config/checkstyle/whalecloud-checkstyle.xml already exists"
+else
+  cat > "$CONFIG_DIR/checkstyle/whalecloud-checkstyle.xml" << 'CHECKSTYLE'
+<?xml version="1.0"?>
+<!DOCTYPE module PUBLIC
+    "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
+    "https://checkstyle.org/dtds/configuration_1_3.dtd">
+<module name="Checker">
+  <module name="TreeWalker">
+    <!-- J000065: Magic number in for loop counter -->
+    <module name="MagicNumber">
+      <property name="ignoreNumbers" value="-1,0,1,2,10,100,1000,60,24,7,30,365,256,1024"/>
+      <property name="ignoreAnnotationElementDefaults" value="true"/>
+    </module>
+    <!-- J000030: Braces in control statements -->
+    <module name="NeedBraces"/>
+    <!-- J000066: Multiple variable assignment -->
+    <module name="MultipleVariableDeclarations"/>
+    <!-- J000072: Left side equals comparison -->
+    <module name="EqualsAvoidNull"/>
+    <!-- J000097: Unused local variables -->
+    <module name="UnusedLocalVariable"/>
+  </module>
+</module>
+CHECKSTYLE
+  echo "  ✅ Created config/checkstyle/whalecloud-checkstyle.xml"
+fi
+
+# SpotBugs configuration
+if [ -f "$CONFIG_DIR/spotbugs/whalecloud-spotbugs.xml" ]; then
+  echo "  ✅ config/spotbugs/whalecloud-spotbugs.xml already exists"
+else
+  cat > "$CONFIG_DIR/spotbugs/whalecloud-spotbugs.xml" << 'SPOTBUGS'
+<?xml version="1.0" encoding="UTF-8"?>
+<FindBugsFilter>
+  <!-- J000017: SimpleDateFormat static usage -->
+  <Match>
+    <Bug pattern="STCAL_INVOKE_ON_STATIC_DATE_FORMAT_INSTANCE"/>
+  </Match>
+  <Match>
+    <Bug pattern="STCAL_INVOKE_ON_STATIC_CALENDAR_INSTANCE"/>
+  </Match>
+  <!-- J000075: MD5 usage -->
+  <Match>
+    <Bug pattern="WEAK_MESSAGE_DIGEST_MD5"/>
+  </Match>
+  <!-- Security: SQL injection -->
+  <Match>
+    <Bug pattern="SQL_NONCONSTANT_STRING_PASSED_TO_STATEMENT"/>
+  </Match>
+  <!-- Security: Command injection -->
+  <Match>
+    <Bug pattern="COMMAND_INJECTION"/>
+  </Match>
+</FindBugsFilter>
+SPOTBUGS
+  echo "  ✅ Created config/spotbugs/whalecloud-spotbugs.xml"
+fi
+
+echo ""
+
+# Step 2: Install Maven profile
+PROFILE_FILE="$PLUGIN_DIR/templates/maven/xp-gate-whalecloud-profile.xml"
+
+if grep -q '<id>xp-gate-whalecloud-java</id>' pom.xml; then
+  echo "Step 2: xp-gate-whalecloud-java profile already exists in pom.xml"
+else
+  echo "Step 2: Installing xp-gate-whalecloud-java profile into pom.xml..."
+
+  if grep -q '<profiles>' pom.xml; then
+    PROFILES_END_LINE=$(grep -n '</profiles>' pom.xml | head -1 | cut -d: -f1)
+    if [ -n "$PROFILES_END_LINE" ]; then
+      head -n $((PROFILES_END_LINE - 1)) pom.xml > pom.xml.tmp
+      {
+        echo ""
+        echo "    <!-- XP-Gate: WhaleCloud Java Coding Standards profile -->"
+        sed 's/^/    /' "$PROFILE_FILE"
+        echo ""
+      } >> pom.xml.tmp
+      tail -n +"$PROFILES_END_LINE" pom.xml >> pom.xml.tmp
+      mv pom.xml.tmp pom.xml
+    fi
+  else
+    PROJECT_END_LINE=$(grep -n '</project>' pom.xml | tail -1 | cut -d: -f1)
+    if [ -n "$PROJECT_END_LINE" ]; then
+      head -n $((PROJECT_END_LINE - 1)) pom.xml > pom.xml.tmp
+      {
+        echo ""
+        echo "  <!-- XP-Gate: WhaleCloud Java Coding Standards profile -->"
+        echo "  <profiles>"
+        sed 's/^/    /' "$PROFILE_FILE"
+        echo ""
+        echo "  </profiles>"
+        echo ""
+      } >> pom.xml.tmp
+      tail -n +"$PROJECT_END_LINE" pom.xml >> pom.xml.tmp
+      mv pom.xml.tmp pom.xml
+    fi
+  fi
+  echo "  ✅ Profile installed successfully"
+fi
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "   Usage"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "  # Run WhaleCloud Java quality checks:"
+echo "  mvn clean verify -P xp-gate-whalecloud-java"
+echo ""
+echo "  # Run with both p3c-pmd and WhaleCloud:"
+echo "  mvn clean verify -P xp-gate-p3c,xp-gate-whalecloud-java"
+echo ""
+echo "  # This will be integrated into XP-Gate pre-commit Gate 1"
+echo ""