@qodo/sdk 0.10.0 → 0.11.0

package/dist/sdk/trigger-context.js

@@ -0,0 +1,136 @@
+/**
+ * CI Trigger Context — auto-detects the CI provider and extracts
+ * trigger metadata (PR URL, branch, commit SHA, etc.) from environment
+ * variables.  Works across GitHub Actions, GitLab CI, Bitbucket
+ * Pipelines, Gerrit, and a generic fallback.
+ */
+import { readFileSync } from 'node:fs';
+// ---- Provider resolvers (first match wins) ----
+function resolveGitHub() {
+    if (process.env.GITHUB_ACTIONS !== 'true')
+        return null;
+    const ctx = {
+        provider: 'github',
+        event_name: process.env.GITHUB_EVENT_NAME,
+        branch: process.env.GITHUB_HEAD_REF || process.env.GITHUB_REF_NAME,
+        base_branch: process.env.GITHUB_BASE_REF || undefined,
+        repo_url: process.env.GITHUB_SERVER_URL && process.env.GITHUB_REPOSITORY
+            ? `${process.env.GITHUB_SERVER_URL}/${process.env.GITHUB_REPOSITORY}`
+            : undefined,
+        commit_sha: process.env.GITHUB_SHA,
+    };
+    // Extract tag for release/tag events
+    const ref = process.env.GITHUB_REF ?? '';
+    if (ref.startsWith('refs/tags/')) {
+        ctx.tag = ref.replace('refs/tags/', '');
+    }
+    // Extract pr_url from the event payload JSON
+    const eventPath = process.env.GITHUB_EVENT_PATH;
+    if (eventPath) {
+        try {
+            const raw = readFileSync(eventPath, 'utf-8');
+            const event = JSON.parse(raw);
+            ctx.pr_url = event?.pull_request?.html_url ?? undefined;
+        }
+        catch {
+            // Ignore — file may not exist or be malformed
+        }
+    }
+    // Fallback for pr_url
+    if (!ctx.pr_url) {
+        ctx.pr_url = process.env.PR_URL || process.env.QODO_PR_URL || undefined;
+    }
+    return ctx;
+}
+function resolveGitLab() {
+    if (process.env.GITLAB_CI !== 'true')
+        return null;
+    const ctx = {
+        provider: 'gitlab',
+        event_name: process.env.CI_PIPELINE_SOURCE,
+        branch: process.env.CI_COMMIT_BRANCH || process.env.CI_MERGE_REQUEST_SOURCE_BRANCH_NAME,
+        base_branch: process.env.CI_MERGE_REQUEST_TARGET_BRANCH_NAME || undefined,
+        repo_url: process.env.CI_PROJECT_URL || undefined,
+        commit_sha: process.env.CI_COMMIT_SHA,
+    };
+    // Build MR URL
+    const mrIid = process.env.CI_MERGE_REQUEST_IID;
+    const projectUrl = process.env.CI_PROJECT_URL;
+    if (mrIid && projectUrl) {
+        ctx.pr_url = `${projectUrl}/-/merge_requests/${mrIid}`;
+    }
+    // Tag
+    if (process.env.CI_COMMIT_TAG) {
+        ctx.tag = process.env.CI_COMMIT_TAG;
+    }
+    return ctx;
+}
+function resolveBitbucket() {
+    if (!process.env.BITBUCKET_PIPELINE_UUID)
+        return null;
+    const ctx = {
+        provider: 'bitbucket',
+        branch: process.env.BITBUCKET_BRANCH,
+        repo_url: process.env.BITBUCKET_GIT_HTTP_ORIGIN || undefined,
+        commit_sha: process.env.BITBUCKET_COMMIT,
+    };
+    // Infer event_name from PR presence
+    const prId = process.env.BITBUCKET_PR_ID;
+    if (prId) {
+        ctx.event_name = 'pull_request';
+        const origin = process.env.BITBUCKET_GIT_HTTP_ORIGIN;
+        if (origin) {
+            ctx.pr_url = `${origin}/pull-requests/${prId}`;
+        }
+        ctx.base_branch = process.env.BITBUCKET_PR_DESTINATION_BRANCH || undefined;
+    }
+    // Tag
+    if (process.env.BITBUCKET_TAG) {
+        ctx.tag = process.env.BITBUCKET_TAG;
+    }
+    return ctx;
+}
+function resolveGerrit() {
+    if (!process.env.GERRIT_CHANGE_URL)
+        return null;
+    return {
+        provider: 'gerrit',
+        event_name: process.env.GERRIT_EVENT_TYPE,
+        pr_url: process.env.GERRIT_CHANGE_URL,
+        branch: process.env.GERRIT_BRANCH,
+        commit_sha: process.env.GERRIT_PATCHSET_REVISION,
+        repo_url: process.env.GERRIT_PROJECT
+            ? `${process.env.GERRIT_CHANGE_URL?.split('/c/')[0] ?? ''}/${process.env.GERRIT_PROJECT}`
+            : undefined,
+    };
+}
+function resolveFallback() {
+    return {
+        provider: 'unknown',
+        pr_url: process.env.PR_URL || process.env.QODO_PR_URL || undefined,
+        branch: process.env.BRANCH || process.env.QODO_BRANCH || undefined,
+        commit_sha: process.env.COMMIT_SHA || process.env.QODO_COMMIT_SHA || undefined,
+        repo_url: process.env.REPO_URL || process.env.QODO_REPO_URL || undefined,
+        tag: process.env.TAG || process.env.QODO_TAG || undefined,
+    };
+}
+// ---- Public API ----
+/**
+ * Auto-detect the CI provider and extract trigger context from environment
+ * variables.  Optional `overrides` are merged on top (non-undefined values
+ * win).
+ */
+export function resolveTriggerContext(overrides) {
+    const detected = resolveGitHub() ??
+        resolveGitLab() ??
+        resolveBitbucket() ??
+        resolveGerrit() ??
+        resolveFallback();
+    if (!overrides)
+        return detected;
+    return {
+        ...detected,
+        ...Object.fromEntries(Object.entries(overrides).filter(([, v]) => v !== undefined)),
+    };
+}
+//# sourceMappingURL=trigger-context.js.map

package/dist/sdk/trigger-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-context.js","sourceRoot":"","sources":["../../src/sdk/trigger-context.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qodo/sdk",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Qodo SDK for building AI-powered agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,7 +18,8 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "qodo-install-skill": "./dist/bin/install-skill.js"
+    "qodo-install-skill": "./dist/bin/install-skill.js",
+    "qodo-sdk": "./dist/bin/run.js"
   },
   "files": [
     "dist",
@@ -43,7 +44,7 @@
     "node": ">=18"
   },
   "scripts": {
-    "build": "npm run clean && tsc && chmod +x dist/bin/install-skill.js",
+    "build": "npm run clean && tsc && chmod +x dist/bin/install-skill.js dist/bin/run.js",
     "dev": "tsc --watch",
     "clean": "rm -rf dist",
     "typecheck": "tsc --noEmit",