@hellopearl/dv-gitlab 0.2.4 → 0.4.0

package/ci/e2e-enforce.yml

@@ -0,0 +1,102 @@
+# 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
+
+      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.2.4",
+  "version": "0.4.0",
   "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": "b64d016cde27cd43ab1abfec4da8f5b8787355bc"
 }

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 || '' },
     ],
   };
 
@@ -227,7 +229,7 @@ export async function postbuild() {
   const deleted = await client.deleteNotesByMarker(
     projectId,
     mr.iid,
-    '<!-- dv-gitlab:preview -->',
+    '<!-- amplify:build-status -->',
   );
   if (deleted) {
     debug(`[postbuild] removed ${deleted} stale preview comment(s)`);
@@ -249,24 +251,28 @@ export async function postbuild() {
   await client.deleteNotesByMarker(
     projectId,
     mr.iid,
-    '<!-- dv-gitlab:pipeline -->',
+    '<!-- amplify:pipeline-trigger -->',
   );
 
   const triggerResult = await triggerPipelinePreview({
     appId,
     branch,
     mrIid: mr.iid.toString(),
+    previewUrl,
     projectId: projectId.toString(),
     token,
   });
 
   if (triggerResult) {
     const triggerBody = renderTemplate('pipeline-triggered', {
+      branch,
+      capture: process.env.QA_PIPELINE_CAPTURE || '',
       environment: process.env.QA_PIPELINE_ENVIRONMENT || '',
       pipelineId: triggerResult.id.toString(),
       pipelineUrl: triggerResult.webUrl,
       project: process.env.QA_PIPELINE_PROJECT || '',
       ref: process.env.QA_PIPELINE_REF || '',
+      scope: process.env.QA_PIPELINE_SCOPE || '',
     });
 
     const triggerPosted = await client.postNote(projectId, mr.iid, triggerBody);

package/src/templates/pipeline-triggered.md

@@ -1,13 +1,17 @@
-<!-- dv-gitlab:pipeline -->
-## 🔄 Automation Pipeline Triggered
+<!-- amplify:pipeline-trigger -->
+## :gear: Automation Pipeline Triggered
 
-|                 |                                    |
-| --------------- | ---------------------------------- |
-| **Pipeline**    | [#{{pipelineId}}]({{pipelineUrl}}) |
-| **Project**     | `{{project}}`                      |
-| **Ref**         | `{{ref}}`                          |
-| **Environment** | `{{environment}}`                  |
+| | |
+|---|---|
+| **Pipeline** | [#{{pipelineId}}]({{pipelineUrl}}) |
+| **Branch** | `{{branch}}` |
+| **Ref** | `{{ref}}` |
+| **Project** | `{{project}}` |
+| **Environment** | `{{environment}}` |
+| **Scope** | `{{scope}}` |
+| **Capture** | `{{capture}}` |
 
----
+:hourglass_flowing_sand: Results will be posted here when the pipeline completes.
 
-Results will be posted here once the pipeline completes.
+---
+:robot: *Posted by Amplify*

package/src/templates/preview-failed.md

@@ -1,11 +1,15 @@
-<!-- dv-gitlab:preview -->
-## ❌ Preview Build Failed
+<!-- amplify:build-status -->
+## :x: Preview Build Failed
 
-|            |                |
-| ---------- | -------------- |
-| **Branch** | `{{branch}}`   |
+| | |
+|---|---|
+| **Branch** | `{{branch}}` |
 | **Commit** | `{{commitId}}` |
+| **Console** | [Amplify Build Logs](https://{{region}}.console.aws.amazon.com/amplify/home#/{{appId}}/{{branch}}/{{jobId}}) |
 
----
+```diff
+- Build failed -- check console for details
+```
 
-The Amplify preview build did not complete successfully. Check the [Amplify Console](https://{{region}}.console.aws.amazon.com/amplify/home#/{{appId}}/{{branch}}) for details.
+---
+:robot: *Posted by Amplify*

package/src/templates/preview-ready.md

@@ -1,19 +1,18 @@
-<!-- dv-gitlab:preview -->
-## 🚀 Preview Environment Ready
+<!-- amplify:build-status -->
+## :white_check_mark: Preview Environment Ready
 
-|                 |                                  |
-| --------------- | -------------------------------- |
-| **Branch**      | `{{branch}}`                     |
-| **Commit**      | `{{commitId}}`                   |
-| **Preview URL** | [{{previewUrl}}]({{previewUrl}}) |
+:rocket: **[Open Preview]({{previewUrl}})**
 
----
-
-<details>
-<summary>Build details</summary>
+| | |
+|---|---|
+| **Branch** | `{{branch}}` |
+| **Commit** | `{{commitId}}` |
+| **Preview** | {{previewUrl}} |
+| **Console** | [Amplify Build Logs](https://{{region}}.console.aws.amazon.com/amplify/home#/{{appId}}/{{branch}}/{{jobId}}) |
 
-- **App ID:** `{{appId}}`
-- **Job ID:** `{{jobId}}`
-- **Region:** `{{region}}`
+```diff
++ Build succeeded -- preview is live
+```
 
-</details>
+---
+:robot: *Posted by Amplify*