@hellopearl/dv-gitlab 0.3.0 → 0.4.1

package/ci/e2e-enforce.yml

@@ -0,0 +1,107 @@
+# Reusable template: enforce green E2E on MRs.
+# Waits for an Amplify preview to go live, triggers pearl-test-automation,
+# then polls until the pipeline finishes — failing if tests are red.
+#
+# Consumer usage:
+#   include:
+#     - project: 'hellopearl/pearl-agentic-mono'
+#       ref: main
+#       file: '/packages/dev/dv-gitlab/ci/e2e-enforce.yml'
+#
+#   e2e:
+#     extends: .e2e-enforce
+#     variables:
+#       E2E_PROJECT: Voice           # pearl-test-automation project name
+#       PREVIEW_DOMAIN: voice.hellopearl.com
+
+.e2e-enforce:
+  stage: e2e
+  image: node:24-alpine
+  before_script:
+    - apk add --no-cache curl jq
+  variables:
+    QA_PROJECT_ID: "59469690"
+    E2E_PROJECT: ""
+    E2E_SCOPE: "All"
+    E2E_ENV: "dev"
+    PREVIEW_DOMAIN: ""
+    PREVIEW_WAIT_ATTEMPTS: "60"
+    PREVIEW_WAIT_INTERVAL: "10"
+    PIPELINE_POLL_ATTEMPTS: "180"
+    PIPELINE_POLL_INTERVAL: "10"
+  script:
+    - |
+      if [ -z "$E2E_PROJECT" ] || [ -z "$PREVIEW_DOMAIN" ]; then
+        echo "[e2e-enforce] ERROR: E2E_PROJECT and PREVIEW_DOMAIN must be set"
+        exit 1
+      fi
+
+      if [ -z "$GITLAB_API_TOKEN" ]; then
+        echo "[e2e-enforce] GITLAB_API_TOKEN not set — skipping E2E (configure in CI/CD variables)"
+        exit 0
+      fi
+
+      BRANCH_SLUG=$(echo "$CI_COMMIT_REF_NAME" | tr '[:upper:]' '[:lower:]' | sed 's|/|-|g')
+      PREVIEW_URL="https://${BRANCH_SLUG}.${PREVIEW_DOMAIN}"
+      echo "[e2e-enforce] Preview URL: $PREVIEW_URL"
+      echo "[e2e-enforce] Project: $E2E_PROJECT | Scope: $E2E_SCOPE | Env: $E2E_ENV"
+
+      # ── Wait for Amplify preview ──
+      echo "[e2e-enforce] Waiting for preview to go live..."
+      for i in $(seq 1 "$PREVIEW_WAIT_ATTEMPTS"); do
+        STATUS=$(curl -s -o /dev/null -w "%{http_code}" "$PREVIEW_URL" 2>/dev/null || echo "000")
+        [ "$STATUS" = "200" ] && break
+        echo "[e2e-enforce] Attempt $i/${PREVIEW_WAIT_ATTEMPTS} — HTTP $STATUS"
+        sleep "$PREVIEW_WAIT_INTERVAL"
+      done
+      if [ "$STATUS" != "200" ]; then
+        echo "[e2e-enforce] Preview not available — skipping (non-blocking)"
+        exit 0
+      fi
+      echo "[e2e-enforce] Preview is live."
+
+      # ── Trigger pearl-test-automation ──
+      RESPONSE=$(curl -s --header "PRIVATE-TOKEN: ${GITLAB_API_TOKEN}" \
+        --header "Content-Type: application/json" \
+        --request POST \
+        "https://gitlab.com/api/v4/projects/${QA_PROJECT_ID}/pipeline" \
+        --data "{
+          \"ref\": \"main\",
+          \"variables\": [
+            {\"key\": \"PROJECT\", \"value\": \"$E2E_PROJECT\"},
+            {\"key\": \"ENV\", \"value\": \"$E2E_ENV\"},
+            {\"key\": \"SCOPE\", \"value\": \"$E2E_SCOPE\"},
+            {\"key\": \"PREVIEW_URL\", \"value\": \"$PREVIEW_URL\"},
+            {\"key\": \"SOURCE_PROJECT_ID\", \"value\": \"$CI_PROJECT_ID\"},
+            {\"key\": \"SOURCE_MR_IID\", \"value\": \"$CI_MERGE_REQUEST_IID\"}
+          ]
+        }")
+      PIPELINE_ID=$(echo "$RESPONSE" | jq -r '.id // empty')
+      PIPELINE_URL=$(echo "$RESPONSE" | jq -r '.web_url // empty')
+
+      if [ -z "$PIPELINE_ID" ]; then
+        echo "[e2e-enforce] Failed to trigger: $RESPONSE"
+        exit 1
+      fi
+      echo "[e2e-enforce] Triggered: $PIPELINE_URL"
+
+      # ── Poll for result ──
+      for i in $(seq 1 "$PIPELINE_POLL_ATTEMPTS"); do
+        sleep "$PIPELINE_POLL_INTERVAL"
+        PSTATUS=$(curl -s --header "PRIVATE-TOKEN: ${GITLAB_API_TOKEN}" \
+          "https://gitlab.com/api/v4/projects/${QA_PROJECT_ID}/pipelines/$PIPELINE_ID" \
+          | jq -r '.status')
+        case "$PSTATUS" in
+          success)
+            echo "[e2e-enforce] ✅ E2E PASSED — $PIPELINE_URL"
+            exit 0 ;;
+          failed|canceled)
+            echo "[e2e-enforce] ❌ E2E $PSTATUS — $PIPELINE_URL"
+            exit 1 ;;
+        esac
+        [ $((i % 6)) -eq 0 ] && echo "[e2e-enforce] Still running ($((i * PIPELINE_POLL_INTERVAL))s)..."
+      done
+      echo "[e2e-enforce] ❌ Timed out — $PIPELINE_URL"
+      exit 1
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"

package/ci/quality-gate.yml

@@ -0,0 +1,59 @@
+# Reusable template: code quality gate for MRs.
+# Runs format check (Prettier), lint (ESLint), and optional style lint.
+# Uses @hellopearl/dv-prettier and @hellopearl/dv-lint from the monorepo.
+#
+# Consumer usage:
+#   include:
+#     - project: 'hellopearl/pearl-agentic-mono'
+#       ref: main
+#       file: '/packages/dev/dv-gitlab/ci/quality-gate.yml'
+#
+#   quality:
+#     extends: .quality-gate
+#     variables:
+#       QUALITY_LINT_PROFILE: client   # server | client | e2e
+
+.quality-gate:
+  stage: test
+  image: node:24-alpine
+  before_script:
+    - corepack enable || true
+    - yarn install --immutable 2>/dev/null || npm ci 2>/dev/null || true
+  variables:
+    QUALITY_FORMAT_CHECK: "true"
+    QUALITY_LINT: "true"
+    QUALITY_STYLELINT: "false"
+    QUALITY_LINT_PROFILE: "client"
+    QUALITY_FORMAT_GLOB: "src/**/*.{ts,tsx,js,jsx,mjs}"
+    QUALITY_STYLELINT_GLOB: "src/**/*.scss"
+  script:
+    - |
+      EXIT=0
+
+      if [ "$QUALITY_FORMAT_CHECK" = "true" ]; then
+        echo "══════════════════════════════════════════"
+        echo "[quality] Prettier (@hellopearl/dv-prettier)"
+        echo "══════════════════════════════════════════"
+        yarn format:check \
+          || { echo "[quality] ❌ Format check failed — run: yarn format"; EXIT=1; }
+      fi
+
+      if [ "$QUALITY_LINT" = "true" ]; then
+        echo "══════════════════════════════════════════"
+        echo "[quality] ESLint (@hellopearl/dv-lint)"
+        echo "══════════════════════════════════════════"
+        yarn lint \
+          || { echo "[quality] ❌ Lint failed"; EXIT=1; }
+      fi
+
+      if [ "$QUALITY_STYLELINT" = "true" ]; then
+        echo "══════════════════════════════════════════"
+        echo "[quality] Stylelint"
+        echo "══════════════════════════════════════════"
+        npx stylelint "$QUALITY_STYLELINT_GLOB" \
+          || { echo "[quality] ❌ Stylelint failed"; EXIT=1; }
+      fi
+
+      exit $EXIT
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hellopearl/dv-gitlab",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Unified GitLab CI tooling -- MR comments, pipeline triggers, preview env management",
   "license": "UNLICENSED",
   "type": "module",
@@ -8,13 +8,11 @@
   "exports": {
     ".": "./src/index.mjs"
   },
-  "bin": {
-    "dv-gitlab": "./bin/dv-gitlab.mjs"
-  },
+  "bin": "./bin/dv-gitlab.mjs",
   "files": [
     "bin",
-    "src",
-    "ci"
+    "ci",
+    "src"
   ],
   "scripts": {
     "deps": "dv-deps-runner",
@@ -46,5 +44,6 @@
     "@hellopearl/dv-lint": "*",
     "@hellopearl/dv-prettier": "*",
     "@hellopearl/dv-test": "*"
-  }
+  },
+  "gitHead": "5fe68171d5da113bf355f6ee8eda1ce4bbceb800"
 }

package/src/commands/cleanup-branch.mjs

@@ -26,10 +26,11 @@ export async function cleanupBranch(flags) {
 
   debug(`cleanup-branch branch=${branch} appId=${appId} region=${region}`);
 
-  log(`[cleanup] Deleting Amplify branch: ${branch} (app=${appId})`);
+  const amplifyBranch = branch.toLowerCase().replace(/\//g, '-');
+  log(`[cleanup] Deleting Amplify branch: ${amplifyBranch} (app=${appId})`);
 
   const client = new AmplifyClient({ appId, region });
-  const ok = await client.deleteBranch(branch);
+  const ok = await client.deleteBranch(amplifyBranch);
 
   if (ok) {
     log(`[cleanup] Branch ${amplifyBranch} removed successfully`);

package/src/commands/postbuild.mjs

@@ -90,6 +90,7 @@ async function triggerPipelinePreview({
   mrIid,
   branch,
   appId,
+  previewUrl,
 }) {
   const pipelineUrl = process.env.QA_PIPELINE_URL;
   const triggerToken = process.env.QA_PIPELINE_TRIGGER_TOKEN || token;
@@ -113,6 +114,7 @@ async function triggerPipelinePreview({
       { key: 'BRANCH', value: branch },
       { key: 'AMPLIFY_APP_ID', value: appId },
       { key: 'PREVIEW_DOMAIN', value: process.env.PREVIEW_DOMAIN || '' },
+      { key: 'PREVIEW_URL', value: previewUrl || '' },
     ],
   };
 
@@ -224,13 +226,20 @@ export async function postbuild() {
     region,
   });
 
-  const deleted = await client.deleteNotesByMarker(
-    projectId,
-    mr.iid,
+  const markers = [
     '<!-- amplify:build-status -->',
-  );
-  if (deleted) {
-    debug(`[postbuild] removed ${deleted} stale preview comment(s)`);
+    '<!-- amplify:pipeline-trigger -->',
+    '<!-- qa:automation-results -->',
+  ];
+  for (const marker of markers) {
+    const deleted = await client.deleteNotesByMarker(
+      projectId,
+      mr.iid,
+      marker,
+    );
+    if (deleted) {
+      debug(`[postbuild] removed ${deleted} stale comment(s) [${marker}]`);
+    }
   }
 
   const posted = await client.postNote(projectId, mr.iid, commentBody);
@@ -246,16 +255,11 @@ export async function postbuild() {
     return;
   }
 
-  await client.deleteNotesByMarker(
-    projectId,
-    mr.iid,
-    '<!-- amplify:pipeline-trigger -->',
-  );
-
   const triggerResult = await triggerPipelinePreview({
     appId,
     branch,
     mrIid: mr.iid.toString(),
+    previewUrl,
     projectId: projectId.toString(),
     token,
   });