@supaku/agentfactory-linear 0.7.18 → 0.7.20

package/dist/src/agent-client-project-repo.test.js

@@ -1,6 +1,7 @@
 import { describe, it, expect, vi } from 'vitest';
 import { LinearAgentClient } from './agent-client.js';
 import { TokenBucket } from './rate-limiter.js';
+import { CircuitBreaker } from './circuit-breaker.js';
 // ---------------------------------------------------------------------------
 // Mock helpers
 // ---------------------------------------------------------------------------
@@ -30,6 +31,7 @@ function createClientWithProject(project) {
         writable: false,
     });
     Object.defineProperty(client, 'rateLimiter', { value: new TokenBucket(), writable: false });
+    Object.defineProperty(client, 'circuitBreaker', { value: new CircuitBreaker(), writable: false });
     Object.defineProperty(client, 'statusCache', { value: new Map(), writable: false });
     return client;
 }

package/dist/src/agent-client.d.ts

@@ -9,6 +9,7 @@ export declare class LinearAgentClient {
     private readonly client;
     private readonly retryConfig;
     private readonly rateLimiter;
+    private readonly circuitBreaker;
     private statusCache;
     constructor(config: LinearAgentClientConfig);
     /**
@@ -16,11 +17,15 @@ export declare class LinearAgentClient {
      */
     get linearClient(): LinearClient;
     /**
-     * Execute an operation with retry logic and rate limiting.
+     * Execute an operation with circuit breaker, rate limiting, and retry logic.
      *
-     * On HTTP 429 (rate limited):
-     * - Uses the Retry-After header value for the wait delay (falls back to 60s)
-     * - Penalizes the token bucket so concurrent callers also back off
+     * Order of operations:
+     * 1. Check circuit breaker — if open, throw CircuitOpenError (zero quota consumed)
+     * 2. Acquire rate limit token
+     * 3. Execute the operation
+     * 4. On success: record success on circuit breaker
+     * 5. On auth error: record failure on circuit breaker (may trip it)
+     * 6. On retryable error: retry with exponential backoff
      */
     private withRetry;
     /**
@@ -136,6 +141,8 @@ export declare class LinearAgentClient {
     /**
      * Get all relations for an issue (both outgoing and incoming)
      *
+     * Uses a single raw GraphQL query instead of N+1 lazy-loaded SDK calls.
+     *
      * @param issueId - The issue ID or identifier (e.g., "SUP-123")
      * @returns Relations result with both directions of relationships
      */
@@ -194,6 +201,7 @@ export declare class LinearAgentClient {
     /**
      * Get lightweight sub-issue statuses (no blocking relations)
      *
+     * Uses a single raw GraphQL query instead of N+1 lazy-loaded SDK calls.
      * Returns identifier, title, and status for each sub-issue.
      * Used by QA and acceptance agents to validate sub-issue completion
      * without the overhead of fetching the full dependency graph.
@@ -216,6 +224,10 @@ export declare class LinearAgentClient {
     /**
      * Get sub-issues with their blocking relations for dependency graph building
      *
+     * Uses a single raw GraphQL query instead of N+1 lazy-loaded SDK calls.
+     * Previous implementation made 2 + 4N + M API calls (where N = children,
+     * M = total relations). This version makes exactly 1 API call.
+     *
      * Builds a complete dependency graph of a parent issue's children, including
      * which sub-issues block which other sub-issues. This is used by the coordinator
      * agent to determine execution order.

package/dist/src/agent-client.d.ts.map

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

package/dist/src/agent-client.js

@@ -2,6 +2,7 @@ import { LinearClient, AgentActivitySignal as LinearAgentActivitySignal, IssueRe
 import { LinearApiError, LinearStatusTransitionError } from './errors.js';
 import { withRetry, DEFAULT_RETRY_CONFIG } from './retry.js';
 import { TokenBucket, extractRetryAfterMs } from './rate-limiter.js';
+import { CircuitBreaker } from './circuit-breaker.js';
 /**
  * Core Linear Agent Client
  * Wraps @linear/sdk with retry logic and helper methods
@@ -10,6 +11,7 @@ export class LinearAgentClient {
     client;
     retryConfig;
     rateLimiter;
+    circuitBreaker;
     statusCache = new Map();
     constructor(config) {
         this.client = new LinearClient({
@@ -20,7 +22,8 @@ export class LinearAgentClient {
             ...DEFAULT_RETRY_CONFIG,
             ...config.retry,
         };
-        this.rateLimiter = new TokenBucket(config.rateLimit);
+        this.rateLimiter = config.rateLimiterStrategy ?? new TokenBucket(config.rateLimit);
+        this.circuitBreaker = config.circuitBreakerStrategy ?? new CircuitBreaker(config.circuitBreaker);
     }
     /**
      * Get the underlying LinearClient instance
@@ -29,16 +32,45 @@ export class LinearAgentClient {
         return this.client;
     }
     /**
-     * Execute an operation with retry logic and rate limiting.
+     * Execute an operation with circuit breaker, rate limiting, and retry logic.
      *
-     * On HTTP 429 (rate limited):
-     * - Uses the Retry-After header value for the wait delay (falls back to 60s)
-     * - Penalizes the token bucket so concurrent callers also back off
+     * Order of operations:
+     * 1. Check circuit breaker — if open, throw CircuitOpenError (zero quota consumed)
+     * 2. Acquire rate limit token
+     * 3. Execute the operation
+     * 4. On success: record success on circuit breaker
+     * 5. On auth error: record failure on circuit breaker (may trip it)
+     * 6. On retryable error: retry with exponential backoff
      */
     async withRetry(fn) {
         return withRetry(async () => {
+            // Check circuit breaker BEFORE acquiring a rate limit token
+            const canProceed = await this.circuitBreaker.canProceed();
+            if (!canProceed) {
+                // Create a descriptive error; if the breaker is a CircuitBreaker instance, use its helper
+                const breaker = this.circuitBreaker;
+                if (typeof breaker.createOpenError === 'function') {
+                    throw breaker.createOpenError();
+                }
+                throw new LinearApiError('Circuit breaker is open — API calls blocked', 503);
+            }
             await this.rateLimiter.acquire();
-            return fn();
+            try {
+                const result = await fn();
+                // Record success to close/reset the circuit
+                await this.circuitBreaker.recordSuccess();
+                return result;
+            }
+            catch (error) {
+                // Check if this is an auth error that should trip the circuit
+                if (this.circuitBreaker.isAuthError(error)) {
+                    const statusCode = extractAuthStatusCode(error);
+                    await this.circuitBreaker.recordAuthFailure(statusCode);
+                    const msg = error instanceof Error ? error.message : String(error);
+                    console.warn(`[LinearAgentClient] Auth error detected (status ${statusCode}), circuit breaker notified: ${msg}`);
+                }
+                throw error;
+            }
         }, {
             config: this.retryConfig,
             getRetryAfterMs: extractRetryAfterMs,
@@ -346,47 +378,79 @@ export class LinearAgentClient {
     /**
      * Get all relations for an issue (both outgoing and incoming)
      *
+     * Uses a single raw GraphQL query instead of N+1 lazy-loaded SDK calls.
+     *
      * @param issueId - The issue ID or identifier (e.g., "SUP-123")
      * @returns Relations result with both directions of relationships
      */
     async getIssueRelations(issueId) {
-        return this.withRetry(async () => {
-            const issue = await this.client.issue(issueId);
-            if (!issue) {
-                throw new LinearApiError(`Issue not found: ${issueId}`, 404);
+        const canProceed = await this.circuitBreaker.canProceed();
+        if (!canProceed) {
+            const breaker = this.circuitBreaker;
+            if (typeof breaker.createOpenError === 'function') {
+                throw breaker.createOpenError();
             }
-            // Get outgoing relations (this issue -> other issues)
-            const relationsConnection = await issue.relations();
-            const relations = [];
-            for (const relation of relationsConnection.nodes) {
-                const relatedIssue = await relation.relatedIssue;
-                relations.push({
-                    id: relation.id,
-                    type: relation.type,
-                    issueId: issue.id,
-                    issueIdentifier: issue.identifier,
-                    relatedIssueId: relatedIssue?.id ?? '',
-                    relatedIssueIdentifier: relatedIssue?.identifier,
-                    createdAt: relation.createdAt,
-                });
+            throw new LinearApiError('Circuit breaker is open — API calls blocked', 503);
+        }
+        await this.rateLimiter.acquire();
+        const query = `
+      query IssueRelations($id: String!) {
+        issue(id: $id) {
+          id
+          identifier
+          relations(first: 50) {
+            nodes {
+              id
+              type
+              createdAt
+              relatedIssue { id identifier }
             }
-            // Get incoming relations (other issues -> this issue)
-            const inverseRelationsConnection = await issue.inverseRelations();
-            const inverseRelations = [];
-            for (const relation of inverseRelationsConnection.nodes) {
-                const sourceIssue = await relation.issue;
-                inverseRelations.push({
-                    id: relation.id,
-                    type: relation.type,
-                    issueId: sourceIssue?.id ?? '',
-                    issueIdentifier: sourceIssue?.identifier,
-                    relatedIssueId: issue.id,
-                    relatedIssueIdentifier: issue.identifier,
-                    createdAt: relation.createdAt,
-                });
+          }
+          inverseRelations(first: 50) {
+            nodes {
+              id
+              type
+              createdAt
+              issue { id identifier }
+            }
+          }
+        }
+      }
+    `;
+        try {
+            const result = await this.client.client.rawRequest(query, { id: issueId });
+            await this.circuitBreaker.recordSuccess();
+            const data = result.data;
+            if (!data.issue) {
+                throw new LinearApiError(`Issue not found: ${issueId}`, 404);
             }
+            const relations = data.issue.relations.nodes.map((rel) => ({
+                id: rel.id,
+                type: rel.type,
+                issueId: data.issue.id,
+                issueIdentifier: data.issue.identifier,
+                relatedIssueId: rel.relatedIssue?.id ?? '',
+                relatedIssueIdentifier: rel.relatedIssue?.identifier,
+                createdAt: new Date(rel.createdAt),
+            }));
+            const inverseRelations = data.issue.inverseRelations.nodes.map((rel) => ({
+                id: rel.id,
+                type: rel.type,
+                issueId: rel.issue?.id ?? '',
+                issueIdentifier: rel.issue?.identifier,
+                relatedIssueId: data.issue.id,
+                relatedIssueIdentifier: data.issue.identifier,
+                createdAt: new Date(rel.createdAt),
+            }));
             return { relations, inverseRelations };
-        });
+        }
+        catch (error) {
+            if (this.circuitBreaker.isAuthError(error)) {
+                const statusCode = extractAuthStatusCode(error);
+                await this.circuitBreaker.recordAuthFailure(statusCode);
+            }
+            throw error;
+        }
     }
     /**
      * Delete an issue relation
@@ -448,6 +512,15 @@ export class LinearAgentClient {
      * @returns Array of issue data with childCount for parent detection
      */
     async listProjectIssues(project) {
+        // Check circuit breaker before consuming rate limit token
+        const canProceed = await this.circuitBreaker.canProceed();
+        if (!canProceed) {
+            const breaker = this.circuitBreaker;
+            if (typeof breaker.createOpenError === 'function') {
+                throw breaker.createOpenError();
+            }
+            throw new LinearApiError('Circuit breaker is open — API calls blocked', 503);
+        }
         await this.rateLimiter.acquire();
         const query = `
       query ListProjectIssues($filter: IssueFilter!) {
@@ -468,25 +541,36 @@ export class LinearAgentClient {
       }
     `;
         const terminalStatuses = ['Accepted', 'Canceled', 'Duplicate'];
-        const result = await this.client.client.rawRequest(query, {
-            filter: {
-                project: { name: { eq: project } },
-                state: { name: { nin: terminalStatuses } },
-            },
-        });
-        const data = result.data;
-        return data.issues.nodes.map((node) => ({
-            id: node.id,
-            identifier: node.identifier,
-            title: node.title,
-            description: node.description ?? undefined,
-            status: node.state?.name ?? 'Backlog',
-            labels: node.labels.nodes.map((l) => l.name),
-            createdAt: new Date(node.createdAt).getTime(),
-            parentId: node.parent?.id ?? undefined,
-            project: node.project?.name ?? undefined,
-            childCount: node.children.nodes.length,
-        }));
+        try {
+            const result = await this.client.client.rawRequest(query, {
+                filter: {
+                    project: { name: { eq: project } },
+                    state: { name: { nin: terminalStatuses } },
+                },
+            });
+            // Record success on circuit breaker
+            await this.circuitBreaker.recordSuccess();
+            const data = result.data;
+            return data.issues.nodes.map((node) => ({
+                id: node.id,
+                identifier: node.identifier,
+                title: node.title,
+                description: node.description ?? undefined,
+                status: node.state?.name ?? 'Backlog',
+                labels: node.labels.nodes.map((l) => l.name),
+                createdAt: new Date(node.createdAt).getTime(),
+                parentId: node.parent?.id ?? undefined,
+                project: node.project?.name ?? undefined,
+                childCount: node.children.nodes.length,
+            }));
+        }
+        catch (error) {
+            if (this.circuitBreaker.isAuthError(error)) {
+                const statusCode = extractAuthStatusCode(error);
+                await this.circuitBreaker.recordAuthFailure(statusCode);
+            }
+            throw error;
+        }
     }
     /**
      * Check if an issue has child issues (is a parent issue)
@@ -507,6 +591,7 @@ export class LinearAgentClient {
     /**
      * Get lightweight sub-issue statuses (no blocking relations)
      *
+     * Uses a single raw GraphQL query instead of N+1 lazy-loaded SDK calls.
      * Returns identifier, title, and status for each sub-issue.
      * Used by QA and acceptance agents to validate sub-issue completion
      * without the overhead of fetching the full dependency graph.
@@ -515,23 +600,48 @@ export class LinearAgentClient {
      * @returns Array of sub-issue statuses
      */
     async getSubIssueStatuses(issueIdOrIdentifier) {
-        return this.withRetry(async () => {
-            const parentIssue = await this.client.issue(issueIdOrIdentifier);
-            if (!parentIssue) {
+        const canProceed = await this.circuitBreaker.canProceed();
+        if (!canProceed) {
+            const breaker = this.circuitBreaker;
+            if (typeof breaker.createOpenError === 'function') {
+                throw breaker.createOpenError();
+            }
+            throw new LinearApiError('Circuit breaker is open — API calls blocked', 503);
+        }
+        await this.rateLimiter.acquire();
+        const query = `
+      query SubIssueStatuses($id: String!) {
+        issue(id: $id) {
+          children(first: 50) {
+            nodes {
+              identifier
+              title
+              state { name }
+            }
+          }
+        }
+      }
+    `;
+        try {
+            const result = await this.client.client.rawRequest(query, { id: issueIdOrIdentifier });
+            await this.circuitBreaker.recordSuccess();
+            const data = result.data;
+            if (!data.issue) {
                 throw new LinearApiError(`Issue not found: ${issueIdOrIdentifier}`, 404);
             }
-            const children = await parentIssue.children();
-            const results = [];
-            for (const child of children.nodes) {
-                const state = await child.state;
-                results.push({
-                    identifier: child.identifier,
-                    title: child.title,
-                    status: state?.name ?? 'Unknown',
-                });
+            return data.issue.children.nodes.map((child) => ({
+                identifier: child.identifier,
+                title: child.title,
+                status: child.state?.name ?? 'Unknown',
+            }));
+        }
+        catch (error) {
+            if (this.circuitBreaker.isAuthError(error)) {
+                const statusCode = extractAuthStatusCode(error);
+                await this.circuitBreaker.recordAuthFailure(statusCode);
             }
-            return results;
-        });
+            throw error;
+        }
     }
     /**
      * Get the repository URL associated with a project via its links or description
@@ -566,6 +676,10 @@ export class LinearAgentClient {
     /**
      * Get sub-issues with their blocking relations for dependency graph building
      *
+     * Uses a single raw GraphQL query instead of N+1 lazy-loaded SDK calls.
+     * Previous implementation made 2 + 4N + M API calls (where N = children,
+     * M = total relations). This version makes exactly 1 API call.
+     *
      * Builds a complete dependency graph of a parent issue's children, including
      * which sub-issues block which other sub-issues. This is used by the coordinator
      * agent to determine execution order.
@@ -574,66 +688,99 @@ export class LinearAgentClient {
      * @returns The sub-issue dependency graph
      */
     async getSubIssueGraph(issueIdOrIdentifier) {
-        return this.withRetry(async () => {
-            const parentIssue = await this.client.issue(issueIdOrIdentifier);
-            if (!parentIssue) {
+        const canProceed = await this.circuitBreaker.canProceed();
+        if (!canProceed) {
+            const breaker = this.circuitBreaker;
+            if (typeof breaker.createOpenError === 'function') {
+                throw breaker.createOpenError();
+            }
+            throw new LinearApiError('Circuit breaker is open — API calls blocked', 503);
+        }
+        await this.rateLimiter.acquire();
+        const query = `
+      query SubIssueGraph($id: String!) {
+        issue(id: $id) {
+          id
+          identifier
+          children(first: 50) {
+            nodes {
+              id
+              identifier
+              title
+              description
+              priority
+              url
+              state { name }
+              labels(first: 20) { nodes { name } }
+              relations(first: 50) {
+                nodes {
+                  type
+                  relatedIssue { id identifier }
+                }
+              }
+              inverseRelations(first: 50) {
+                nodes {
+                  type
+                  issue { id identifier }
+                }
+              }
+            }
+          }
+        }
+      }
+    `;
+        try {
+            const result = await this.client.client.rawRequest(query, { id: issueIdOrIdentifier });
+            await this.circuitBreaker.recordSuccess();
+            const data = result.data;
+            if (!data.issue) {
                 throw new LinearApiError(`Issue not found: ${issueIdOrIdentifier}`, 404);
             }
-            const children = await parentIssue.children();
-            const subIssueIds = new Set(children.nodes.map((c) => c.id));
-            const subIssueIdentifiers = new Map();
-            // Build identifier map for all sub-issues
-            for (const child of children.nodes) {
-                subIssueIdentifiers.set(child.id, child.identifier);
-            }
-            const graphNodes = [];
-            for (const child of children.nodes) {
-                const state = await child.state;
-                const labels = await child.labels();
-                // Get relations to find blocking dependencies
-                const relations = await child.relations();
-                const inverseRelations = await child.inverseRelations();
+            const parentIssue = data.issue;
+            const subIssueIds = new Set(parentIssue.children.nodes.map((c) => c.id));
+            const graphNodes = parentIssue.children.nodes.map((child) => {
                 const blockedBy = [];
                 const blocks = [];
-                // Check inverse relations - other issues blocking this one
-                for (const rel of inverseRelations.nodes) {
-                    if (rel.type === 'blocks') {
-                        const sourceIssue = await rel.issue;
-                        if (sourceIssue && subIssueIds.has(sourceIssue.id)) {
-                            blockedBy.push(sourceIssue.identifier);
-                        }
+                // Inverse relations: other issues blocking this one
+                for (const rel of child.inverseRelations.nodes) {
+                    if (rel.type === 'blocks' && rel.issue && subIssueIds.has(rel.issue.id)) {
+                        blockedBy.push(rel.issue.identifier);
                     }
                 }
-                // Check outgoing relations - this issue blocking others
-                for (const rel of relations.nodes) {
-                    if (rel.type === 'blocks') {
-                        const relatedIssue = await rel.relatedIssue;
-                        if (relatedIssue && subIssueIds.has(relatedIssue.id)) {
-                            blocks.push(relatedIssue.identifier);
-                        }
+                // Outgoing relations: this issue blocking others
+                for (const rel of child.relations.nodes) {
+                    if (rel.type === 'blocks' && rel.relatedIssue && subIssueIds.has(rel.relatedIssue.id)) {
+                        blocks.push(rel.relatedIssue.identifier);
                     }
                 }
-                graphNodes.push({
+                return {
                     issue: {
                         id: child.id,
                         identifier: child.identifier,
                         title: child.title,
                         description: child.description ?? undefined,
-                        status: state?.name,
+                        status: child.state?.name,
                         priority: child.priority,
-                        labels: labels.nodes.map((l) => l.name),
+                        labels: child.labels.nodes.map((l) => l.name),
                         url: child.url,
                     },
                     blockedBy,
                     blocks,
-                });
-            }
+                };
+            });
             return {
                 parentId: parentIssue.id,
                 parentIdentifier: parentIssue.identifier,
                 subIssues: graphNodes,
             };
-        });
+        }
+        catch (error) {
+            if (this.circuitBreaker.isAuthError(error)) {
+                const statusCode = extractAuthStatusCode(error);
+                await this.circuitBreaker.recordAuthFailure(statusCode);
+            }
+            throw error;
+        }
     }
 }
 /**
@@ -642,3 +789,27 @@ export class LinearAgentClient {
 export function createLinearAgentClient(config) {
     return new LinearAgentClient(config);
 }
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Extract HTTP status code from an error for circuit breaker recording.
+ */
+function extractAuthStatusCode(error) {
+    if (typeof error !== 'object' || error === null)
+        return 0;
+    const err = error;
+    if (typeof err.status === 'number')
+        return err.status;
+    if (typeof err.statusCode === 'number')
+        return err.statusCode;
+    const response = err.response;
+    if (response) {
+        if (typeof response.status === 'number')
+            return response.status;
+        if (typeof response.statusCode === 'number')
+            return response.statusCode;
+    }
+    // Default to 400 for auth errors detected by message pattern
+    return 400;
+}