@lanefoundry/gatelane-ci-adapter 0.0.0-stage → 0.1.0

package/dist/action.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=action.d.ts.map

package/dist/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":""}

package/dist/action.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * gatelane CI/CD action — reads a gate report, sets GitHub Actions outputs,
+ * writes a step summary, and exits with the appropriate code.
+ *
+ * Usage in GitHub Actions:
+ *   - run: node packages/ci-adapter/dist/action.js
+ *     env:
+ *       GATELANE_REPORT_PATH: report.json
+ *
+ * Or pipe from stdin:
+ *   cat report.json | node packages/ci-adapter/dist/action.js
+ */
+import { readFile, appendFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { parseGateOutput, toGitHubOutput, exitCodeForDecision, formatGitHubSummary, } from './index.js';
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks).toString('utf-8');
+}
+async function main() {
+    let jsonString;
+    const reportPath = process.env.GATELANE_REPORT_PATH;
+    if (reportPath) {
+        jsonString = await readFile(resolve(reportPath), 'utf-8');
+    }
+    else if (!process.stdin.isTTY) {
+        jsonString = await readStdin();
+    }
+    else {
+        process.stderr.write('error: set GATELANE_REPORT_PATH or pipe report JSON to stdin\n');
+        return 2;
+    }
+    const parsed = parseGateOutput(jsonString);
+    const outputs = toGitHubOutput(parsed);
+    // Set GitHub Actions outputs via $GITHUB_OUTPUT file
+    const githubOutputFile = process.env.GITHUB_OUTPUT;
+    if (githubOutputFile) {
+        const lines = Object.entries(outputs)
+            .map(([k, v]) => `${k}=${v}`)
+            .join('\n') + '\n';
+        await appendFile(githubOutputFile, lines);
+    }
+    // Write step summary via $GITHUB_STEP_SUMMARY file
+    const summaryFile = process.env.GITHUB_STEP_SUMMARY;
+    if (summaryFile) {
+        await appendFile(summaryFile, formatGitHubSummary(parsed) + '\n');
+    }
+    // Always print to stderr for local visibility
+    process.stderr.write(`\n  gatelane gate: ${parsed.decision.toUpperCase()}\n`);
+    if (parsed.winner)
+        process.stderr.write(`  winner:        ${parsed.winner}\n`);
+    process.stderr.write(`  reason:        ${parsed.reason}\n`);
+    process.stderr.write(`  report:        ${parsed.report_id}\n\n`);
+    // Print outputs as JSON to stdout
+    process.stdout.write(JSON.stringify(outputs, null, 2) + '\n');
+    return exitCodeForDecision(parsed.decision);
+}
+main().then((code) => process.exit(code), (err) => {
+    process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=action.js.map

package/dist/action.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @lanefoundry/gatelane-ci-adapter — parse gatelane gate output for CI/CD.
+ *
+ * Reads the JSON report produced by `gatelane eval --report` or `gatelane run --report`,
+ * extracts the promotion decision, and maps it to GitHub Actions outputs / exit codes.
+ */
+export type GateDecision = 'promote' | 'rollback' | 'hold_for_review';
+export type ParsedGateOutput = {
+    decision: GateDecision;
+    winner?: string;
+    reason: string;
+    report_id: string;
+    signature: string;
+};
+/**
+ * Parse the JSON report from `gatelane eval` or `gatelane run`.
+ * Accepts the full report JSON string.
+ */
+export declare function parseGateOutput(jsonString: string): ParsedGateOutput;
+/**
+ * Map parsed gate output to GitHub Actions output variables.
+ */
+export declare function toGitHubOutput(parsed: ParsedGateOutput): Record<string, string>;
+/**
+ * Map decision to process exit code.
+ * promote / hold_for_review = 0 (CI passes), rollback = 1 (CI fails).
+ */
+export declare function exitCodeForDecision(decision: GateDecision): number;
+/**
+ * Format a markdown summary for GitHub Actions step summary.
+ */
+export declare function formatGitHubSummary(parsed: ParsedGateOutput): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,iBAAiB,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAoBpE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO/E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAElE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAyBpE"}

package/dist/index.js

@@ -0,0 +1,71 @@
+/**
+ * @lanefoundry/gatelane-ci-adapter — parse gatelane gate output for CI/CD.
+ *
+ * Reads the JSON report produced by `gatelane eval --report` or `gatelane run --report`,
+ * extracts the promotion decision, and maps it to GitHub Actions outputs / exit codes.
+ */
+/**
+ * Parse the JSON report from `gatelane eval` or `gatelane run`.
+ * Accepts the full report JSON string.
+ */
+export function parseGateOutput(jsonString) {
+    const raw = JSON.parse(jsonString);
+    const decision = raw.decision;
+    if (!decision || typeof decision !== 'object') {
+        throw new Error('report missing "decision" field');
+    }
+    const action = String(decision.action ?? 'rollback');
+    if (action !== 'promote' && action !== 'rollback' && action !== 'hold_for_review') {
+        throw new Error(`unexpected decision action: "${action}"`);
+    }
+    return {
+        decision: action,
+        winner: 'winner' in decision ? String(decision.winner) : undefined,
+        reason: String(decision.reason ?? ''),
+        report_id: String(raw.report_id ?? raw.gate_run_id ?? ''),
+        signature: String(raw.signature ?? ''),
+    };
+}
+/**
+ * Map parsed gate output to GitHub Actions output variables.
+ */
+export function toGitHubOutput(parsed) {
+    return {
+        GATELANE_DECISION: parsed.decision,
+        GATELANE_WINNER: parsed.winner ?? '',
+        GATELANE_REASON: parsed.reason,
+        GATELANE_REPORT_ID: parsed.report_id,
+    };
+}
+/**
+ * Map decision to process exit code.
+ * promote / hold_for_review = 0 (CI passes), rollback = 1 (CI fails).
+ */
+export function exitCodeForDecision(decision) {
+    return decision === 'rollback' ? 1 : 0;
+}
+/**
+ * Format a markdown summary for GitHub Actions step summary.
+ */
+export function formatGitHubSummary(parsed) {
+    const icon = parsed.decision === 'promote' ? ':white_check_mark:'
+        : parsed.decision === 'hold_for_review' ? ':warning:'
+            : ':x:';
+    const lines = [
+        `## ${icon} gatelane gate: ${parsed.decision.toUpperCase()}`,
+        '',
+    ];
+    if (parsed.winner) {
+        lines.push(`**Winner:** \`${parsed.winner}\``);
+    }
+    lines.push(`**Reason:** ${parsed.reason}`);
+    lines.push(`**Report ID:** \`${parsed.report_id}\``);
+    if (parsed.signature) {
+        lines.push(`**Signature:** \`${parsed.signature.slice(0, 16)}...\``);
+    }
+    lines.push('');
+    lines.push('---');
+    lines.push('*Generated by [gatelane](https://github.com/lanefoundry/gatelane)*');
+    return lines.join('\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "@lanefoundry/gatelane-ci-adapter",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "CI/CD adapter for gatelane — parses gate output for GitHub Actions.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lanefoundry/gatelane.git",
+    "directory": "packages/ci-adapter"
+  },
+  "homepage": "https://github.com/lanefoundry/gatelane/tree/main/packages/ci-adapter",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "gatelane-ci": "./dist/action.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@lanefoundry/gatelane-sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.4"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.