@renseiai/plugin-linear 0.8.6

package/dist/src/issue-tracker-adapter.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Linear Issue Tracker Adapter
+ *
+ * Implements the platform-agnostic IssueTrackerClient interface
+ * by wrapping LinearAgentClient and AgentSession.
+ *
+ * Types are defined locally (structurally identical to core) to avoid
+ * a compile-time dependency on @renseiai/agentfactory.
+ */
+import { LinearAgentClient } from './agent-client.js';
+import type { AgentWorkType } from './types.js';
+/** Platform-agnostic issue representation. */
+export interface IssueTrackerIssue {
+    id: string;
+    identifier: string;
+    title: string;
+    description?: string;
+    url: string;
+    priority: number;
+    status?: string;
+    labels: string[];
+    teamName?: string;
+    projectName?: string;
+}
+/** Configuration for creating an issue tracker session. */
+export interface SessionConfig {
+    issueId: string;
+    sessionId: string;
+    autoTransition?: boolean;
+}
+/** Platform-agnostic session for streaming agent activities. */
+export interface IssueTrackerSession {
+    emitThought(content: string, ephemeral?: boolean): Promise<void>;
+    emitAction(tool: string, input: Record<string, unknown>, ephemeral?: boolean): Promise<void>;
+    emitToolResult(tool: string, output: string, ephemeral?: boolean): Promise<void>;
+    emitResponse(content: string): Promise<void>;
+    emitError(error: Error): Promise<void>;
+    reportEnvironmentIssue(title: string, description: string, options?: unknown): Promise<{
+        id: string;
+        identifier: string;
+        url: string;
+    } | null>;
+    setPullRequestUrl(url: string): Promise<void>;
+    addExternalUrl(url: {
+        url: string;
+        label: string;
+    }): Promise<void>;
+    complete(): Promise<void>;
+}
+/** Comment chunk returned by buildCompletionComments. */
+export interface CommentChunk {
+    body: string;
+    partNumber: number;
+    totalParts: number;
+}
+/** Platform-agnostic issue tracker client. */
+export interface IssueTrackerClient {
+    getIssue(idOrIdentifier: string): Promise<IssueTrackerIssue>;
+    isParentIssue(issueId: string): Promise<boolean>;
+    createComment(issueId: string, body: string): Promise<{
+        id: string;
+    }>;
+    updateIssueStatus(issueId: string, status: string): Promise<void>;
+    unassignIssue(issueId: string): Promise<void>;
+    queryIssues(options: {
+        project?: string;
+        status?: string;
+        maxResults?: number;
+    }): Promise<IssueTrackerIssue[]>;
+    getProjectRepositoryUrl(projectName: string): Promise<string | null>;
+    createSession(config: SessionConfig): IssueTrackerSession;
+    buildCompletionComments(resultMessage: string, planItems: unknown[], sessionId: string | null): CommentChunk[];
+}
+/** Maps between workflow statuses and agent work types. */
+export interface WorkTypeStatusMappings {
+    statusToWorkType: Record<string, AgentWorkType>;
+    workTypeStartStatus: Record<AgentWorkType, string | null>;
+    workTypeCompleteStatus: Record<AgentWorkType, string | null>;
+    workTypeFailStatus: Record<AgentWorkType, string | null>;
+    terminalStatuses: readonly string[];
+    workTypesRequiringWorktree: ReadonlySet<AgentWorkType>;
+}
+/**
+ * Implements IssueTrackerClient by wrapping LinearAgentClient.
+ * Injected into the orchestrator at construction time.
+ */
+export declare class LinearIssueTrackerClient implements IssueTrackerClient {
+    readonly linearClient: LinearAgentClient;
+    constructor(config: {
+        apiKey: string;
+    });
+    getIssue(idOrIdentifier: string): Promise<IssueTrackerIssue>;
+    isParentIssue(issueId: string): Promise<boolean>;
+    createComment(issueId: string, body: string): Promise<{
+        id: string;
+    }>;
+    updateIssueStatus(issueId: string, status: string): Promise<void>;
+    unassignIssue(issueId: string): Promise<void>;
+    queryIssues(options: {
+        project?: string;
+        status?: string;
+        maxResults?: number;
+    }): Promise<IssueTrackerIssue[]>;
+    getProjectRepositoryUrl(projectName: string): Promise<string | null>;
+    createSession(config: SessionConfig): IssueTrackerSession;
+    buildCompletionComments(resultMessage: string, planItems: unknown[], sessionId: string | null): CommentChunk[];
+}
+/**
+ * Create the default Linear status mappings.
+ * These map between Linear workflow statuses and agent work types.
+ */
+export declare function createLinearStatusMappings(): WorkTypeStatusMappings;
+//# sourceMappingURL=issue-tracker-adapter.d.ts.map

package/dist/src/issue-tracker-adapter.d.ts.map

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

package/dist/src/issue-tracker-adapter.js

@@ -0,0 +1,169 @@
+/**
+ * Linear Issue Tracker Adapter
+ *
+ * Implements the platform-agnostic IssueTrackerClient interface
+ * by wrapping LinearAgentClient and AgentSession.
+ *
+ * Types are defined locally (structurally identical to core) to avoid
+ * a compile-time dependency on @renseiai/agentfactory.
+ */
+import { createLinearAgentClient } from './agent-client.js';
+import { createAgentSession } from './agent-session.js';
+import { buildCompletionComments } from './utils.js';
+import { STATUS_WORK_TYPE_MAP, WORK_TYPE_START_STATUS, WORK_TYPE_COMPLETE_STATUS, WORK_TYPE_FAIL_STATUS, TERMINAL_STATUSES, WORK_TYPES_REQUIRING_WORKTREE, } from './types.js';
+/**
+ * Wraps a Linear AgentSession to implement IssueTrackerSession.
+ */
+class LinearIssueTrackerSession {
+    session;
+    constructor(session) {
+        this.session = session;
+    }
+    async emitThought(content, ephemeral) {
+        await this.session.emitThought(content, ephemeral);
+    }
+    async emitAction(tool, input, ephemeral) {
+        await this.session.emitAction(tool, input, ephemeral);
+    }
+    async emitToolResult(tool, output, ephemeral) {
+        await this.session.emitToolResult(tool, output, ephemeral);
+    }
+    async emitResponse(content) {
+        await this.session.emitResponse(content);
+    }
+    async emitError(error) {
+        await this.session.emitError(error);
+    }
+    async reportEnvironmentIssue(title, description, options) {
+        return this.session.reportEnvironmentIssue(title, description, options);
+    }
+    async setPullRequestUrl(url) {
+        await this.session.setPullRequestUrl(url);
+    }
+    async addExternalUrl(url) {
+        await this.session.addExternalUrl(url.label, url.url);
+    }
+    async complete() {
+        await this.session.complete();
+    }
+}
+/**
+ * Implements IssueTrackerClient by wrapping LinearAgentClient.
+ * Injected into the orchestrator at construction time.
+ */
+export class LinearIssueTrackerClient {
+    linearClient;
+    constructor(config) {
+        this.linearClient = createLinearAgentClient({ apiKey: config.apiKey });
+    }
+    async getIssue(idOrIdentifier) {
+        const issue = await this.linearClient.getIssue(idOrIdentifier);
+        const state = await issue.state;
+        const team = await issue.team;
+        const project = await issue.project;
+        const labels = await issue.labels();
+        return {
+            id: issue.id,
+            identifier: issue.identifier,
+            title: issue.title,
+            description: issue.description ?? undefined,
+            url: issue.url,
+            priority: issue.priority,
+            status: state?.name,
+            labels: labels.nodes.map((l) => l.name),
+            teamName: team?.key,
+            projectName: project?.name,
+        };
+    }
+    async isParentIssue(issueId) {
+        return this.linearClient.isParentIssue(issueId);
+    }
+    async createComment(issueId, body) {
+        const comment = await this.linearClient.createComment(issueId, body);
+        return { id: comment.id };
+    }
+    async updateIssueStatus(issueId, status) {
+        await this.linearClient.updateIssueStatus(issueId, status);
+    }
+    async unassignIssue(issueId) {
+        await this.linearClient.unassignIssue(issueId);
+    }
+    async queryIssues(options) {
+        const filter = {};
+        if (options.status) {
+            filter.state = { name: { eqIgnoreCase: options.status } };
+        }
+        if (options.project) {
+            const projects = await this.linearClient.linearClient.projects({
+                filter: { name: { eqIgnoreCase: options.project } },
+            });
+            if (projects.nodes.length > 0) {
+                filter.project = { id: { eq: projects.nodes[0].id } };
+            }
+        }
+        const issues = await this.linearClient.linearClient.issues({
+            filter,
+            first: options.maxResults ?? 50,
+        });
+        const results = [];
+        for (const issue of issues.nodes) {
+            const state = await issue.state;
+            const team = await issue.team;
+            const project = await issue.project;
+            const labels = await issue.labels();
+            results.push({
+                id: issue.id,
+                identifier: issue.identifier,
+                title: issue.title,
+                description: issue.description ?? undefined,
+                url: issue.url,
+                priority: issue.priority,
+                status: state?.name,
+                labels: labels.nodes.map((l) => l.name),
+                teamName: team?.key,
+                projectName: project?.name,
+            });
+        }
+        return results;
+    }
+    async getProjectRepositoryUrl(projectName) {
+        const projects = await this.linearClient.linearClient.projects({
+            filter: { name: { eqIgnoreCase: projectName } },
+        });
+        if (projects.nodes.length === 0)
+            return null;
+        // Use the LinearAgentClient's method if available
+        try {
+            return await this.linearClient.getProjectRepositoryUrl(projects.nodes[0].id);
+        }
+        catch {
+            return null;
+        }
+    }
+    createSession(config) {
+        const session = createAgentSession({
+            client: this.linearClient.linearClient,
+            issueId: config.issueId,
+            sessionId: config.sessionId,
+            autoTransition: config.autoTransition ?? false,
+        });
+        return new LinearIssueTrackerSession(session);
+    }
+    buildCompletionComments(resultMessage, planItems, sessionId) {
+        return buildCompletionComments(resultMessage, planItems, sessionId);
+    }
+}
+/**
+ * Create the default Linear status mappings.
+ * These map between Linear workflow statuses and agent work types.
+ */
+export function createLinearStatusMappings() {
+    return {
+        statusToWorkType: STATUS_WORK_TYPE_MAP,
+        workTypeStartStatus: WORK_TYPE_START_STATUS,
+        workTypeCompleteStatus: WORK_TYPE_COMPLETE_STATUS,
+        workTypeFailStatus: WORK_TYPE_FAIL_STATUS,
+        terminalStatuses: TERMINAL_STATUSES,
+        workTypesRequiringWorktree: WORK_TYPES_REQUIRING_WORKTREE,
+    };
+}

package/dist/src/issue-tracker-proxy.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Platform-Agnostic Issue Tracker Proxy Interface
+ *
+ * Defines the contract between agents/governors and the centralized proxy.
+ * Agents call these methods without knowing whether the backend is Linear,
+ * Jira, GitHub Issues, or any future platform.
+ *
+ * The proxy translates these generic operations into platform-specific API calls.
+ */
+/**
+ * Every proxy request carries authentication and workspace context.
+ */
+export interface ProxyRequest {
+    /** The operation to perform */
+    method: IssueTrackerMethod;
+    /** Arguments for the operation (method-specific) */
+    args: unknown[];
+    /** Workspace/organization ID for multi-tenant routing */
+    organizationId?: string;
+}
+/**
+ * Standard proxy response envelope.
+ */
+export interface ProxyResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    };
+    /** Rate limit info from the upstream platform */
+    quota?: {
+        requestsRemaining?: number;
+        complexityRemaining?: number;
+        resetAt?: number;
+    };
+}
+/**
+ * All operations that can be routed through the proxy.
+ *
+ * Named generically (not Linear-specific) so future platforms
+ * can implement the same interface.
+ */
+export type IssueTrackerMethod = 'getIssue' | 'updateIssue' | 'createIssue' | 'createComment' | 'getIssueComments' | 'getTeamStatuses' | 'updateIssueStatus' | 'createAgentActivity' | 'updateAgentSession' | 'createAgentSessionOnIssue' | 'createIssueRelation' | 'getIssueRelations' | 'deleteIssueRelation' | 'getSubIssues' | 'getSubIssueStatuses' | 'getSubIssueGraph' | 'isParentIssue' | 'isChildIssue' | 'listProjectIssues' | 'getProjectRepositoryUrl' | 'getViewer' | 'getTeam' | 'unassignIssue';
+/**
+ * Serialized issue — all relations pre-resolved to plain JSON.
+ * No SDK-specific Promise fields or lazy loaders.
+ */
+export interface SerializedIssue {
+    id: string;
+    identifier: string;
+    title: string;
+    description?: string;
+    url: string;
+    priority: number;
+    state?: {
+        id: string;
+        name: string;
+        type: string;
+    };
+    labels: Array<{
+        id: string;
+        name: string;
+    }>;
+    assignee?: {
+        id: string;
+        name: string;
+        email?: string;
+    } | null;
+    team?: {
+        id: string;
+        name: string;
+        key: string;
+    };
+    parent?: {
+        id: string;
+        identifier: string;
+    } | null;
+    project?: {
+        id: string;
+        name: string;
+    } | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Serialized comment.
+ */
+export interface SerializedComment {
+    id: string;
+    body: string;
+    createdAt: string;
+    updatedAt: string;
+    user?: {
+        id: string;
+        name: string;
+    } | null;
+}
+/**
+ * Serialized viewer (authenticated user).
+ */
+export interface SerializedViewer {
+    id: string;
+    name: string;
+    email: string;
+}
+/**
+ * Serialized team.
+ */
+export interface SerializedTeam {
+    id: string;
+    name: string;
+    key: string;
+}
+/**
+ * Health status for the proxy endpoint.
+ */
+export interface ProxyHealthStatus {
+    /** Whether the proxy can process requests */
+    healthy: boolean;
+    /** Circuit breaker state */
+    circuitBreaker: {
+        state: string;
+        failures: number;
+        msSinceOpened: number | null;
+    };
+    /** Rate limiter status */
+    rateLimiter: {
+        availableTokens: number;
+    };
+    /** Upstream platform quota from response headers */
+    quota: {
+        requestsRemaining: number | null;
+        complexityRemaining: number | null;
+        resetAt: number | null;
+        updatedAt: number;
+    };
+}
+//# sourceMappingURL=issue-tracker-proxy.d.ts.map

package/dist/src/issue-tracker-proxy.d.ts.map

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

package/dist/src/issue-tracker-proxy.js

@@ -0,0 +1,10 @@
+/**
+ * Platform-Agnostic Issue Tracker Proxy Interface
+ *
+ * Defines the contract between agents/governors and the centralized proxy.
+ * Agents call these methods without knowing whether the backend is Linear,
+ * Jira, GitHub Issues, or any future platform.
+ *
+ * The proxy translates these generic operations into platform-specific API calls.
+ */
+export {};

package/dist/src/platform-adapter.d.ts

@@ -0,0 +1,132 @@
+/**
+ * LinearPlatformAdapter
+ *
+ * Extends LinearFrontendAdapter with Governor event integration methods.
+ * Structurally satisfies the PlatformAdapter interface from @renseiai/agentfactory
+ * without an explicit `implements` clause, avoiding a circular package dependency
+ * (core depends on linear, so linear cannot import core).
+ *
+ * Responsibilities:
+ * - Normalize Linear webhook payloads into GovernorEvents
+ * - Scan Linear projects for non-terminal issues
+ * - Convert Linear SDK Issue objects to GovernorIssue
+ */
+import { LinearFrontendAdapter } from './frontend-adapter.js';
+import type { LinearAgentClient } from './agent-client.js';
+/**
+ * Minimal issue representation used by the Governor.
+ * Structurally identical to GovernorIssue in @renseiai/agentfactory.
+ */
+export interface GovernorIssue {
+    id: string;
+    identifier: string;
+    title: string;
+    description?: string;
+    status: string;
+    labels: string[];
+    createdAt: number;
+    parentId?: string;
+    project?: string;
+}
+/** Where an event originated. */
+type EventSource = 'webhook' | 'poll' | 'manual';
+/**
+ * Fired when an issue's workflow status changes.
+ * Structurally identical to IssueStatusChangedEvent in @renseiai/agentfactory.
+ */
+interface IssueStatusChangedEvent {
+    type: 'issue-status-changed';
+    issueId: string;
+    issue: GovernorIssue;
+    previousStatus?: string;
+    newStatus: string;
+    timestamp: string;
+    source: EventSource;
+}
+/**
+ * Fired when a comment is added to an issue.
+ * Structurally identical to CommentAddedEvent in @renseiai/agentfactory.
+ */
+interface CommentAddedEvent {
+    type: 'comment-added';
+    issueId: string;
+    issue: GovernorIssue;
+    commentId: string;
+    commentBody: string;
+    userId?: string;
+    userName?: string;
+    timestamp: string;
+    source: EventSource;
+}
+/** Union of events this adapter can produce. */
+type GovernorEvent = IssueStatusChangedEvent | CommentAddedEvent;
+/**
+ * Linear platform adapter for the EventDrivenGovernor.
+ *
+ * Extends LinearFrontendAdapter to inherit all frontend operations
+ * (status mapping, issue read/write, agent sessions) and adds
+ * Governor-specific methods for webhook normalization, project scanning,
+ * and issue conversion.
+ *
+ * Structurally satisfies PlatformAdapter from @renseiai/agentfactory.
+ */
+export declare class LinearPlatformAdapter extends LinearFrontendAdapter {
+    /**
+     * The underlying Linear client, exposed to subclass methods.
+     * Re-declared here because the parent's `client` field is private.
+     */
+    private readonly linearAgentClient;
+    constructor(client: LinearAgentClient);
+    /**
+     * Normalize a raw Linear webhook payload into GovernorEvents.
+     *
+     * Handles two payload types:
+     * - Issue updates with state changes -> IssueStatusChangedEvent
+     * - Comment creations -> CommentAddedEvent
+     *
+     * Returns `null` for unrecognized payloads (e.g., label changes,
+     * AgentSession events, or other resource types).
+     *
+     * @param payload - Raw Linear webhook payload
+     * @returns Array of GovernorEvents, or null if not relevant
+     */
+    normalizeWebhookEvent(payload: unknown): GovernorEvent[] | null;
+    /**
+     * Scan a Linear project for all non-terminal issues.
+     *
+     * Uses a single GraphQL query via `listProjectIssues()` to fetch all
+     * issue data in one API call, eliminating the N+1 problem of lazy-loading
+     * state/labels/parent/project for each issue.
+     *
+     * @param project - Linear project name to scan
+     * @returns Array of GovernorIssue for all active issues
+     */
+    scanProjectIssues(project: string): Promise<GovernorIssue[]>;
+    /**
+     * Scan a project and return both GovernorIssues and a set of parent issue IDs.
+     *
+     * The parent issue IDs are derived from `childCount > 0` in the single
+     * GraphQL query, allowing callers to skip per-issue `isParentIssue()` API calls.
+     *
+     * @param project - Linear project name to scan
+     * @returns Issues and a set of parent issue IDs
+     */
+    scanProjectIssuesWithParents(project: string): Promise<{
+        issues: GovernorIssue[];
+        parentIssueIds: Set<string>;
+    }>;
+    /**
+     * Convert a Linear SDK Issue object to a GovernorIssue.
+     *
+     * The `native` parameter is typed as `unknown` to satisfy the
+     * PlatformAdapter interface. Internally it is cast to the Linear SDK
+     * `Issue` type. Callers must ensure they pass a valid Linear Issue.
+     *
+     * @param native - Linear SDK Issue object
+     * @returns GovernorIssue representation
+     * @throws Error if the native object is not a valid Linear Issue
+     */
+    toGovernorIssue(native: unknown): Promise<GovernorIssue>;
+}
+export {};
+//# sourceMappingURL=platform-adapter.d.ts.map

package/dist/src/platform-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-adapter.d.ts","sourceRoot":"","sources":["../../src/platform-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAY1D;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,iCAAiC;AACjC,KAAK,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;AAEhD;;;GAGG;AACH,UAAU,uBAAuB;IAC/B,IAAI,EAAE,sBAAsB,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,aAAa,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,WAAW,CAAA;CACpB;AAED;;;GAGG;AACH,UAAU,iBAAiB;IACzB,IAAI,EAAE,eAAe,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,aAAa,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,WAAW,CAAA;CACpB;AAED,gDAAgD;AAChD,KAAK,aAAa,GAAG,uBAAuB,GAAG,iBAAiB,CAAA;AAmJhE;;;;;;;;;GASG;AACH,qBAAa,qBAAsB,SAAQ,qBAAqB;IAC9D;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;gBAEzC,MAAM,EAAE,iBAAiB;IAOrC;;;;;;;;;;;;OAYG;IACH,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,EAAE,GAAG,IAAI;IA0D/D;;;;;;;;;OASG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAgBlE;;;;;;;;OAQG;IACG,4BAA4B,CAChC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QAAC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;IA0BpE;;;;;;;;;;OAUG;IACG,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;CAS/D"}