@stackbilt/ci 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @stackbilt/ci — GitHub Actions helpers
+ *
+ * Provides formatting utilities for GitHub Actions output:
+ * - Status check annotations
+ * - PR comment formatting
+ * - GITHUB_OUTPUT helpers
+ *
+ * These are utility functions used by the GitHub Action workflow.
+ * The actual workflow YAML is in the repo root at .github/actions/.
+ */
+import type { DriftViolation, GitValidationStatus } from '@stackbilt/types';
+/**
+ * Write a GitHub Actions output variable.
+ */
+export declare function setOutput(name: string, value: string): void;
+/**
+ * Write a GitHub Actions step summary.
+ */
+export declare function setSummary(markdown: string): void;
+/**
+ * Emit GitHub Actions annotations for drift violations.
+ * Shows inline warnings/errors on PR file diffs.
+ */
+export declare function annotateDriftViolations(violations: DriftViolation[]): void;
+/**
+ * Emit a GitHub Actions annotation for validation status.
+ */
+export declare function annotateValidationStatus(status: GitValidationStatus, summary: string): void;
+/**
+ * Format a governance check result as a PR comment body.
+ */
+export declare function formatPRComment(result: {
+    status: string;
+    summary: string;
+    violations?: DriftViolation[];
+    suggestions?: string[];
+    score?: number;
+}): 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;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAM5E;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAM3D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMjD;AAMD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,IAAI,CAM1E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,GACd,IAAI,CAMN;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAsCT"}

package/dist/index.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * @stackbilt/ci — GitHub Actions helpers
+ *
+ * Provides formatting utilities for GitHub Actions output:
+ * - Status check annotations
+ * - PR comment formatting
+ * - GITHUB_OUTPUT helpers
+ *
+ * These are utility functions used by the GitHub Action workflow.
+ * The actual workflow YAML is in the repo root at .github/actions/.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setOutput = setOutput;
+exports.setSummary = setSummary;
+exports.annotateDriftViolations = annotateDriftViolations;
+exports.annotateValidationStatus = annotateValidationStatus;
+exports.formatPRComment = formatPRComment;
+// ============================================================================
+// GitHub Actions Output
+// ============================================================================
+/**
+ * Write a GitHub Actions output variable.
+ */
+function setOutput(name, value) {
+    const outputFile = process.env.GITHUB_OUTPUT;
+    if (outputFile) {
+        const fs = require('node:fs');
+        fs.appendFileSync(outputFile, `${name}=${value}\n`);
+    }
+}
+/**
+ * Write a GitHub Actions step summary.
+ */
+function setSummary(markdown) {
+    const summaryFile = process.env.GITHUB_STEP_SUMMARY;
+    if (summaryFile) {
+        const fs = require('node:fs');
+        fs.appendFileSync(summaryFile, markdown + '\n');
+    }
+}
+// ============================================================================
+// Annotations
+// ============================================================================
+/**
+ * Emit GitHub Actions annotations for drift violations.
+ * Shows inline warnings/errors on PR file diffs.
+ */
+function annotateDriftViolations(violations) {
+    for (const v of violations) {
+        const level = v.severity === 'BLOCKER' || v.severity === 'CRITICAL' ? 'error' : 'warning';
+        // GitHub Actions annotation format
+        console.log(`::${level} file=${v.file},line=${v.line}::${v.patternName}: ${v.snippet}`);
+    }
+}
+/**
+ * Emit a GitHub Actions annotation for validation status.
+ */
+function annotateValidationStatus(status, summary) {
+    if (status === 'FAIL') {
+        console.log(`::error::Governance validation failed: ${summary}`);
+    }
+    else if (status === 'WARN') {
+        console.log(`::warning::Governance validation warning: ${summary}`);
+    }
+}
+// ============================================================================
+// PR Comment Formatting
+// ============================================================================
+/**
+ * Format a governance check result as a PR comment body.
+ */
+function formatPRComment(result) {
+    const icon = result.status === 'PASS' ? '✅'
+        : result.status === 'WARN' ? '⚠️'
+            : '❌';
+    const lines = [
+        `## ${icon} Charter Governance Check`,
+        '',
+        `**Status:** ${result.status}`,
+        `**Summary:** ${result.summary}`,
+    ];
+    if (result.score !== undefined) {
+        lines.push(`**Drift Score:** ${Math.round(result.score * 100)}%`);
+    }
+    if (result.violations && result.violations.length > 0) {
+        lines.push('', '### Violations', '');
+        lines.push('| File | Line | Pattern | Snippet |');
+        lines.push('|------|------|---------|---------|');
+        for (const v of result.violations.slice(0, 20)) {
+            lines.push(`| \`${v.file}\` | ${v.line} | ${v.patternName} | \`${v.snippet.slice(0, 50)}\` |`);
+        }
+        if (result.violations.length > 20) {
+            lines.push(`| ... | | | ${result.violations.length - 20} more violations |`);
+        }
+    }
+    if (result.suggestions && result.suggestions.length > 0) {
+        lines.push('', '### Suggestions', '');
+        for (const s of result.suggestions) {
+            lines.push(`- ${s}`);
+        }
+    }
+    lines.push('', '---', '*Generated by [Charter](https://github.com/stackbilt-dev/charter-kit)*');
+    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

@@ -0,0 +1,34 @@
+{
+  "name": "@stackbilt/ci",
+  "version": "0.1.1",
+  "description": "GitHub Actions adapter for Charter governance checks",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Stackbilt-dev/charter.git",
+    "directory": "packages/ci"
+  },
+  "bugs": {
+    "url": "https://github.com/Stackbilt-dev/charter/issues"
+  },
+  "homepage": "https://github.com/Stackbilt-dev/charter#readme",
+  "dependencies": {
+    "@stackbilt/types": "workspace:*"
+  },
+  "license": "Apache-2.0"
+}