@herjarsa/omo-meta-governor 0.24.4 → 0.24.7

package/dist/ci-monitor.d.ts

@@ -0,0 +1,71 @@
+/**
+ * CI Monitor — v0.25.0
+ *
+ * Auto-triggers GitHub Actions workflow on `git push` and surfaces failures
+ * to the agent so it can fix issues without waiting for local test runs.
+ *
+ * Why this exists: local `bun test` takes ~3 min (e2e + sqlite integration
+ * tests). The user prefers to push and have the plugin monitor CI in the
+ * cloud, then inject failure context if CI breaks. This is faster than local
+ * runs because CI runs all 3 OS jobs (linux/macos/windows) in parallel.
+ *
+ * Architecture:
+ * - On `tool.execute.after` (after `bash` with `git push`), spawn a fire-and-
+ *   forget async IIFE that:
+ *   1. Calls `gh workflow run <workflow> --ref <branch>` via gh CLI
+ *   2. Polls `gh run list --limit 1 --json databaseId,status,conclusion` every
+ *      `pollIntervalMs` up to `maxWaitMs`
+ *   3. On failure, stores result in `sessionState.ciFailure` and emits a
+ *      `session.prompt` via `persistSessionMessage()` surfacing the failure
+ *      to the agent
+ * - Auth: gh CLI auto-picks up `$GH_TOKEN` env var (or `~/.config/gh/` auth).
+ *
+ * Config (in meta_governor block):
+ *   ciMonitor.enabled: boolean (default true)
+ *   ciMonitor.workflow: string (default "CI")
+ *   ciMonitor.pollIntervalMs: number (default 15000)
+ *   ciMonitor.maxWaitMs: number (default 600000 = 10 min)
+ *   ciMonitor.failOnly: boolean (default true) — only inject if CI failed
+ */
+export interface CIMonitorConfig {
+    enabled: boolean;
+    workflow: string;
+    pollIntervalMs: number;
+    maxWaitMs: number;
+    failOnly: boolean;
+}
+export declare const DEFAULT_CI_MONITOR_CONFIG: CIMonitorConfig;
+export interface CIRunStatus {
+    databaseId: number;
+    status: "queued" | "in_progress" | "completed" | "waiting" | "requested";
+    conclusion: "success" | "failure" | "neutral" | "cancelled" | "skipped" | "timed_out" | "action_required" | null;
+    displayTitle: string;
+    url: string;
+    headSha: string;
+}
+/**
+ * Get the latest run for the given SHA. Returns null if no run exists yet
+ * (workflow may have been queued — poll again after a short delay).
+ */
+export declare function getLatestRunForSha(sha: string): CIRunStatus | null;
+/**
+ * Poll the given run ID until it completes or the timeout elapses.
+ * Returns the final status, or a synthetic "timed_out" run when the deadline
+ * is hit (caller decides whether to surface this as a CI failure).
+ */
+export declare function pollRunUntilComplete(databaseId: number, config: CIMonitorConfig): CIRunStatus | null;
+/**
+ * Trigger a workflow_dispatch event for the current branch. Returns the run
+ * ID or null on failure. Does NOT wait — caller should poll separately.
+ *
+ * Note: `gh workflow run` requires either an existing .github/workflows/*.yml
+ * with `workflow_dispatch` trigger, OR a push event that already started.
+ * For repo's where CI only runs on push, the run starts automatically when
+ * the push lands — we poll for the resulting run instead.
+ */
+export declare function triggerWorkflow(workflow: string, branch: string): number | null;
+/**
+ * Pull the failed-job logs (truncated) for injection. Uses `gh run view
+ * --log-failed` which already excludes passing steps.
+ */
+export declare function getFailedLogs(databaseId: number, maxChars?: number): string;