@jem-open/mbali-linear

A WorkSource driver for mbali backed by Linear (GraphQL): exhaustive pagination and a label-based claim/fail lifecycle so tickets convert into agent runs exactly once.

This is a port adapter for mbali, not a general Linear client. LinearWorkSource implements the WorkSource port from @jem-open/mbali-core — poll returns admissible WorkItems, and the claim/fail labels mark progress — so it only does anything wired into an Engine. On its own it won't dispatch anything.

Install

pnpm add @jem-open/mbali-linear
pnpm add @jem-open/mbali-core   # peer dependency

Usage

import { LinearWorkSource } from "@jem-open/mbali-linear";

const worksource = new LinearWorkSource({
  apiKey: process.env.LINEAR_API_KEY!,
  teamId: process.env.LINEAR_TEAM_ID!,
  claimLabel: "ai:claimed",
  failLabel: "ai:failed",
});

const plane = { id: "eng", trigger: { worksource, query: { label: "ai" } }, /* … */ };

poll exhausts every page (tune with pageSize), and a per-plane query.scope.team overrides the constructor team so one driver can serve cross-team planes. Ships HealthCheckable diagnostics for mbali doctor.

Part of mbali — the control plane for fleets of remote AI agent sessions.