first commit

packages/@n8n/ai-workflow-builder.ee/evaluations/cli/ci-metadata.ts

@@ -0,0 +1,38 @@
+/**
+ * CI Metadata for LangSmith experiments.
+ *
+ * Provides metadata to distinguish CI runs from local development runs
+ * and to track provenance of automated evaluation results.
+ *
+ * Note: Git info (commit SHA, branch) is not included here as LangSmith
+ * automatically tracks it via LANGSMITH_REVISION_ID and LANGSMITH_BRANCH.
+ */
+
+export interface CIMetadata {
+	/** Whether this run is from CI or local development */
+	source: 'ci' | 'local';
+	/** The GitHub Actions event that triggered this run (e.g., 'push', 'release', 'workflow_dispatch') */
+	trigger?: string;
+	/** The GitHub Actions run ID for linking back to the workflow run */
+	runId?: string;
+}
+
+/**
+ * Build CI metadata from environment variables.
+ *
+ * When running in GitHub Actions, populates metadata from standard GH environment variables.
+ * When running locally, only sets source to 'local'.
+ */
+export function buildCIMetadata(): CIMetadata {
+	const isCI = process.env.GITHUB_ACTIONS === 'true';
+
+	if (!isCI) {
+		return { source: 'local' };
+	}
+
+	return {
+		source: 'ci',
+		trigger: process.env.GITHUB_EVENT_NAME,
+		runId: process.env.GITHUB_RUN_ID,
+	};
+}