@supaku/agentfactory-linear 0.7.10 → 0.7.12

package/dist/src/agent-client-project-repo.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-client-project-repo.test.d.ts.map

package/dist/src/agent-client-project-repo.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client-project-repo.test.d.ts","sourceRoot":"","sources":["../../src/agent-client-project-repo.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,149 @@
+import { describe, it, expect, vi } from 'vitest';
+import { LinearAgentClient } from './agent-client.js';
+// ---------------------------------------------------------------------------
+// Mock helpers
+// ---------------------------------------------------------------------------
+/**
+ * Create a mock project with configurable external links and description.
+ */
+function mockProject(overrides = {}) {
+    const { id = 'project-1', description = null, externalLinks = [], } = overrides;
+    return {
+        id,
+        description,
+        externalLinks: () => Promise.resolve({ nodes: externalLinks }),
+    };
+}
+/**
+ * Create a LinearAgentClient with a mocked LinearClient.
+ */
+function createClientWithProject(project) {
+    const mockLinearClient = {
+        project: vi.fn().mockResolvedValue(project),
+    };
+    // Construct client bypassing the constructor by setting private fields directly
+    const client = Object.create(LinearAgentClient.prototype);
+    Object.defineProperty(client, 'client', { value: mockLinearClient, writable: false });
+    Object.defineProperty(client, 'retryConfig', {
+        value: { maxRetries: 0, baseDelay: 0, maxDelay: 0 },
+        writable: false,
+    });
+    Object.defineProperty(client, 'statusCache', { value: new Map(), writable: false });
+    return client;
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('LinearAgentClient.getProjectRepositoryUrl', () => {
+    it('returns URL from project external link with "Repository" label', async () => {
+        const project = mockProject({
+            externalLinks: [
+                { label: 'Repository', url: 'https://github.com/org/repo' },
+            ],
+        });
+        const client = createClientWithProject(project);
+        const result = await client.getProjectRepositoryUrl('project-1');
+        expect(result).toBe('https://github.com/org/repo');
+    });
+    it('returns URL from project external link with "GitHub" label (case-insensitive)', async () => {
+        const project = mockProject({
+            externalLinks: [
+                { label: 'github', url: 'https://github.com/org/another-repo' },
+            ],
+        });
+        const client = createClientWithProject(project);
+        const result = await client.getProjectRepositoryUrl('project-1');
+        expect(result).toBe('https://github.com/org/another-repo');
+    });
+    it('returns URL from project external link with "REPOSITORY" label (uppercase)', async () => {
+        const project = mockProject({
+            externalLinks: [
+                { label: 'REPOSITORY', url: 'https://github.com/org/upper-repo' },
+            ],
+        });
+        const client = createClientWithProject(project);
+        const result = await client.getProjectRepositoryUrl('project-1');
+        expect(result).toBe('https://github.com/org/upper-repo');
+    });
+    it('returns URL from project description fallback', async () => {
+        const project = mockProject({
+            description: 'This is a project.\nRepository: https://github.com/org/desc-repo\nMore info.',
+            externalLinks: [],
+        });
+        const client = createClientWithProject(project);
+        const result = await client.getProjectRepositoryUrl('project-1');
+        expect(result).toBe('https://github.com/org/desc-repo');
+    });
+    it('returns URL from project description with case-insensitive matching', async () => {
+        const project = mockProject({
+            description: 'repository: github.com/org/lower-desc-repo',
+            externalLinks: [],
+        });
+        const client = createClientWithProject(project);
+        const result = await client.getProjectRepositoryUrl('project-1');
+        expect(result).toBe('github.com/org/lower-desc-repo');
+    });
+    it('prefers external link over description when both are present', async () => {
+        const project = mockProject({
+            description: 'Repository: https://github.com/org/desc-repo',
+            externalLinks: [
+                { label: 'Repository', url: 'https://github.com/org/link-repo' },
+            ],
+        });
+        const client = createClientWithProject(project);
+        const result = await client.getProjectRepositoryUrl('project-1');
+        expect(result).toBe('https://github.com/org/link-repo');
+    });
+    it('returns null when no link or description match', async () => {
+        const project = mockProject({
+            description: 'This project has no repo URL.',
+            externalLinks: [
+                { label: 'Documentation', url: 'https://docs.example.com' },
+            ],
+        });
+        const client = createClientWithProject(project);
+        const result = await client.getProjectRepositoryUrl('project-1');
+        expect(result).toBeNull();
+    });
+    it('returns null when project has no links and no description', async () => {
+        const project = mockProject({
+            description: null,
+            externalLinks: [],
+        });
+        const client = createClientWithProject(project);
+        const result = await client.getProjectRepositoryUrl('project-1');
+        expect(result).toBeNull();
+    });
+    it('handles projects with empty external links gracefully', async () => {
+        const project = mockProject({
+            description: null,
+            externalLinks: [],
+        });
+        const client = createClientWithProject(project);
+        const result = await client.getProjectRepositoryUrl('project-1');
+        expect(result).toBeNull();
+    });
+    it('skips links without a label', async () => {
+        const project = mockProject({
+            externalLinks: [
+                { url: 'https://github.com/org/no-label-repo' },
+            ],
+        });
+        const client = createClientWithProject(project);
+        const result = await client.getProjectRepositoryUrl('project-1');
+        expect(result).toBeNull();
+    });
+    it('finds the matching link among multiple external links', async () => {
+        const project = mockProject({
+            externalLinks: [
+                { label: 'Documentation', url: 'https://docs.example.com' },
+                { label: 'Figma', url: 'https://figma.com/project' },
+                { label: 'GitHub', url: 'https://github.com/org/found-repo' },
+                { label: 'Slack', url: 'https://slack.com/channel' },
+            ],
+        });
+        const client = createClientWithProject(project);
+        const result = await client.getProjectRepositoryUrl('project-1');
+        expect(result).toBe('https://github.com/org/found-repo');
+    });
+});

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

@@ -176,6 +176,17 @@ export declare class LinearAgentClient {
      * @returns Array of sub-issue statuses
      */
     getSubIssueStatuses(issueIdOrIdentifier: string): Promise<SubIssueStatus[]>;
+    /**
+     * Get the repository URL associated with a project via its links or description
+     *
+     * Checks project links for a link with label matching 'Repository' or 'GitHub'
+     * (case-insensitive). Falls back to parsing the project description for a
+     * "Repository: <url>" pattern.
+     *
+     * @param projectId - The project ID
+     * @returns The repository URL if found, null otherwise
+     */
+    getProjectRepositoryUrl(projectId: string): Promise<string | null>;
     /**
      * Get sub-issues with their blocking relations for dependency graph building
      *

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

@@ -467,6 +467,36 @@ export class LinearAgentClient {
             return results;
         });
     }
+    /**
+     * Get the repository URL associated with a project via its links or description
+     *
+     * Checks project links for a link with label matching 'Repository' or 'GitHub'
+     * (case-insensitive). Falls back to parsing the project description for a
+     * "Repository: <url>" pattern.
+     *
+     * @param projectId - The project ID
+     * @returns The repository URL if found, null otherwise
+     */
+    async getProjectRepositoryUrl(projectId) {
+        return this.withRetry(async () => {
+            const project = await this.client.project(projectId);
+            // Check project external links for a Repository/GitHub link
+            const links = await project.externalLinks();
+            for (const link of links.nodes) {
+                if (link.label && /^(repository|github)$/i.test(link.label)) {
+                    return link.url;
+                }
+            }
+            // Fallback: check project description for Repository: pattern
+            if (project.description) {
+                const match = project.description.match(/Repository:\s*([\S]+)/i);
+                if (match) {
+                    return match[1];
+                }
+            }
+            return null;
+        });
+    }
     /**
      * Get sub-issues with their blocking relations for dependency graph building
      *

package/dist/src/index.d.ts

@@ -16,4 +16,6 @@ export * from './webhook-types.js';
 export { LinearFrontendAdapter } from './frontend-adapter.js';
 export type { AbstractStatus as LinearAbstractStatus, AbstractIssue as LinearAbstractIssue, AbstractComment as LinearAbstractComment, ExternalUrl as LinearExternalUrl, CreateIssueInput as LinearCreateIssueInput, UpdateSessionInput as LinearUpdateSessionInput, } from './frontend-adapter.js';
 export { defaultGeneratePrompt, defaultBuildParentQAContext, defaultBuildParentAcceptanceContext, buildFailureContextBlock, WORK_RESULT_MARKER_INSTRUCTION, PR_SELECTION_GUIDANCE, defaultDetectWorkTypeFromPrompt, defaultGetPriority, defaultParseAutoTriggerConfig, type DefaultAutoTriggerConfig, type WorkflowContext, } from './defaults/index.js';
+export { LinearPlatformAdapter } from './platform-adapter.js';
+export type { GovernorIssue as LinearGovernorIssue } from './platform-adapter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

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

package/dist/src/index.js

@@ -20,3 +20,5 @@ export * from './webhook-types.js';
 export { LinearFrontendAdapter } from './frontend-adapter.js';
 // Default implementations (prompt templates, work type detection, priority, auto-trigger)
 export { defaultGeneratePrompt, defaultBuildParentQAContext, defaultBuildParentAcceptanceContext, buildFailureContextBlock, WORK_RESULT_MARKER_INSTRUCTION, PR_SELECTION_GUIDANCE, defaultDetectWorkTypeFromPrompt, defaultGetPriority, defaultParseAutoTriggerConfig, } from './defaults/index.js';
+// Platform adapter (Governor event integration)
+export { LinearPlatformAdapter } from './platform-adapter.js';

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

@@ -0,0 +1,119 @@
+/**
+ * LinearPlatformAdapter
+ *
+ * Extends LinearFrontendAdapter with Governor event integration methods.
+ * Structurally satisfies the PlatformAdapter interface from @supaku/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 @supaku/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 @supaku/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 @supaku/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 @supaku/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.
+     *
+     * Queries the Linear API with a filter that excludes terminal statuses
+     * (Accepted, Canceled, Duplicate). Each issue is converted to a
+     * GovernorIssue for evaluation by the Governor.
+     *
+     * @param project - Linear project name to scan
+     * @returns Array of GovernorIssue for all active issues
+     */
+    scanProjectIssues(project: string): Promise<GovernorIssue[]>;
+    /**
+     * 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;IAkBlE;;;;;;;;;;OAUG;IACG,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;CAS/D"}

package/dist/src/platform-adapter.js

@@ -0,0 +1,229 @@
+/**
+ * LinearPlatformAdapter
+ *
+ * Extends LinearFrontendAdapter with Governor event integration methods.
+ * Structurally satisfies the PlatformAdapter interface from @supaku/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';
+// ---------------------------------------------------------------------------
+// Terminal statuses
+// ---------------------------------------------------------------------------
+/**
+ * Statuses that represent terminal states in Linear.
+ * Issues in these states are excluded from project scans.
+ */
+const TERMINAL_STATUSES = ['Accepted', 'Canceled', 'Duplicate'];
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Generate an ISO-8601 timestamp for the current moment.
+ * Equivalent to `eventTimestamp()` from @supaku/agentfactory.
+ */
+function eventTimestamp() {
+    return new Date().toISOString();
+}
+/**
+ * Build a GovernorIssue from Linear webhook issue data.
+ * Does not make API calls -- uses only the data present in the webhook payload.
+ */
+function webhookIssueToGovernorIssue(issueData) {
+    return {
+        id: issueData.id,
+        identifier: issueData.identifier,
+        title: issueData.title,
+        description: issueData.description ?? undefined,
+        status: issueData.state?.name ?? 'Backlog',
+        labels: issueData.labels?.map((l) => l.name) ?? [],
+        createdAt: issueData.createdAt
+            ? new Date(issueData.createdAt).getTime()
+            : Date.now(),
+        parentId: issueData.parent?.id,
+        project: issueData.project?.name,
+    };
+}
+/**
+ * Convert a Linear SDK Issue object to a GovernorIssue.
+ * Resolves lazy-loaded relations (state, labels, parent, project).
+ */
+async function sdkIssueToGovernorIssue(issue) {
+    const state = await issue.state;
+    const labels = await issue.labels();
+    const parent = await issue.parent;
+    const project = await issue.project;
+    return {
+        id: issue.id,
+        identifier: issue.identifier,
+        title: issue.title,
+        description: issue.description ?? undefined,
+        status: state?.name ?? 'Backlog',
+        labels: labels.nodes.map((l) => l.name),
+        createdAt: issue.createdAt.getTime(),
+        parentId: parent?.id,
+        project: project?.name,
+    };
+}
+// ---------------------------------------------------------------------------
+// Type guards for webhook payloads
+// ---------------------------------------------------------------------------
+/**
+ * Check if a payload looks like a Linear issue webhook.
+ */
+function isIssuePayload(payload) {
+    if (typeof payload !== 'object' || payload === null)
+        return false;
+    const p = payload;
+    return (p.type === 'Issue' &&
+        typeof p.action === 'string' &&
+        typeof p.data === 'object' &&
+        p.data !== null);
+}
+/**
+ * Check if a payload looks like a Linear comment webhook.
+ */
+function isCommentPayload(payload) {
+    if (typeof payload !== 'object' || payload === null)
+        return false;
+    const p = payload;
+    return (p.type === 'Comment' &&
+        typeof p.action === 'string' &&
+        typeof p.data === 'object' &&
+        p.data !== null);
+}
+// ---------------------------------------------------------------------------
+// LinearPlatformAdapter
+// ---------------------------------------------------------------------------
+/**
+ * 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 @supaku/agentfactory.
+ */
+export class LinearPlatformAdapter extends LinearFrontendAdapter {
+    /**
+     * The underlying Linear client, exposed to subclass methods.
+     * Re-declared here because the parent's `client` field is private.
+     */
+    linearAgentClient;
+    constructor(client) {
+        super(client);
+        this.linearAgentClient = client;
+    }
+    // ---- PlatformAdapter methods ----
+    /**
+     * 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) {
+        // Handle Issue update with state change
+        if (isIssuePayload(payload)) {
+            // Only handle updates (not creates/removes)
+            if (payload.action !== 'update')
+                return null;
+            // Only produce an event if the state actually changed
+            const hasStateChange = payload.updatedFrom?.stateId !== undefined;
+            if (!hasStateChange)
+                return null;
+            const issue = webhookIssueToGovernorIssue(payload.data);
+            const event = {
+                type: 'issue-status-changed',
+                issueId: payload.data.id,
+                issue,
+                newStatus: issue.status,
+                // Previous status name is not directly available from stateId alone;
+                // we only know the stateId changed. The previous status name would
+                // require an API call, so we leave it undefined.
+                previousStatus: undefined,
+                timestamp: eventTimestamp(),
+                source: 'webhook',
+            };
+            return [event];
+        }
+        // Handle Comment creation
+        if (isCommentPayload(payload)) {
+            if (payload.action !== 'create')
+                return null;
+            const commentData = payload.data;
+            const issueData = commentData.issue;
+            if (!issueData)
+                return null;
+            const issue = webhookIssueToGovernorIssue(issueData);
+            const event = {
+                type: 'comment-added',
+                issueId: issueData.id,
+                issue,
+                commentId: commentData.id,
+                commentBody: commentData.body,
+                userId: commentData.user?.id,
+                userName: commentData.user?.name,
+                timestamp: eventTimestamp(),
+                source: 'webhook',
+            };
+            return [event];
+        }
+        // Unrecognized payload type
+        return null;
+    }
+    /**
+     * Scan a Linear project for all non-terminal issues.
+     *
+     * Queries the Linear API with a filter that excludes terminal statuses
+     * (Accepted, Canceled, Duplicate). Each issue is converted to a
+     * GovernorIssue for evaluation by the Governor.
+     *
+     * @param project - Linear project name to scan
+     * @returns Array of GovernorIssue for all active issues
+     */
+    async scanProjectIssues(project) {
+        const linearClient = this.linearAgentClient.linearClient;
+        const issueConnection = await linearClient.issues({
+            filter: {
+                project: { name: { eq: project } },
+                state: { name: { nin: [...TERMINAL_STATUSES] } },
+            },
+        });
+        const results = [];
+        for (const issue of issueConnection.nodes) {
+            results.push(await sdkIssueToGovernorIssue(issue));
+        }
+        return results;
+    }
+    /**
+     * 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
+     */
+    async toGovernorIssue(native) {
+        const issue = native;
+        if (!issue || typeof issue.id !== 'string') {
+            throw new Error('LinearPlatformAdapter.toGovernorIssue: expected a Linear SDK Issue object');
+        }
+        return sdkIssueToGovernorIssue(issue);
+    }
+}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=platform-adapter.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform-adapter.test.d.ts","sourceRoot":"","sources":["../../src/platform-adapter.test.ts"],"names":[],"mappings":""}

package/dist/src/platform-adapter.test.js

@@ -0,0 +1,435 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { LinearPlatformAdapter } from './platform-adapter.js';
+// ---------------------------------------------------------------------------
+// Mock helpers
+// ---------------------------------------------------------------------------
+/**
+ * Create a mock Linear SDK Issue object (matching the pattern from frontend-adapter.test.ts).
+ */
+function mockLinearIssue(overrides = {}) {
+    const { id = 'issue-uuid-1', identifier = 'SUP-100', title = 'Test Issue', description = 'A test issue description', url = 'https://linear.app/team/issue/SUP-100', priority = 2, createdAt = new Date('2025-01-15T10:00:00Z'), stateName = 'Backlog', labels = ['Feature'], parentId = null, projectName = 'MyProject', } = overrides;
+    return {
+        id,
+        identifier,
+        title,
+        description,
+        url,
+        priority,
+        createdAt,
+        get state() {
+            return Promise.resolve(stateName ? { name: stateName } : null);
+        },
+        labels: () => Promise.resolve({ nodes: labels.map((name) => ({ name })) }),
+        get parent() {
+            return Promise.resolve(parentId ? { id: parentId } : null);
+        },
+        get project() {
+            return Promise.resolve(projectName ? { name: projectName } : null);
+        },
+        get team() {
+            return Promise.resolve({ id: 'team-1', name: 'Engineering' });
+        },
+    };
+}
+/**
+ * Create a mock LinearAgentClient for the platform adapter.
+ */
+function createMockClient() {
+    const mocks = {
+        getIssue: vi.fn(),
+        updateIssue: vi.fn(),
+        getTeamStatuses: vi.fn(),
+        updateIssueStatus: vi.fn(),
+        createComment: vi.fn(),
+        getIssueComments: vi.fn(),
+        createIssue: vi.fn(),
+        isParentIssue: vi.fn(),
+        isChildIssue: vi.fn(),
+        getSubIssues: vi.fn(),
+        getIssueRelations: vi.fn(),
+        createIssueRelation: vi.fn(),
+        createAgentSessionOnIssue: vi.fn(),
+        updateAgentSession: vi.fn(),
+        createAgentActivity: vi.fn(),
+    };
+    const linearClient = {
+        issues: vi.fn(),
+        issueLabels: vi.fn(),
+    };
+    const client = {
+        ...mocks,
+        linearClient,
+    };
+    mocks.linearClientIssues = linearClient.issues;
+    return { client, mocks };
+}
+// ---------------------------------------------------------------------------
+// Webhook payload factories
+// ---------------------------------------------------------------------------
+function makeIssueUpdatePayload(overrides = {}) {
+    const { stateName = 'Started', hasStateChange = true, action = 'update', id = 'issue-uuid-1', identifier = 'SUP-100', title = 'Test Issue', description = 'Issue description', labels = [{ name: 'Feature' }], parentId, projectName = 'MyProject', createdAt = '2025-01-15T10:00:00.000Z', } = overrides;
+    return {
+        action,
+        type: 'Issue',
+        data: {
+            id,
+            identifier,
+            title,
+            description,
+            url: `https://linear.app/team/issue/${identifier}`,
+            state: { id: 'state-1', name: stateName, type: 'started' },
+            labels: labels.map((l) => ({ id: `label-${l.name}`, ...l })),
+            parent: parentId ? { id: parentId, identifier: 'SUP-99', title: 'Parent' } : undefined,
+            project: projectName ? { id: 'proj-1', name: projectName } : undefined,
+            createdAt,
+        },
+        updatedFrom: hasStateChange ? { stateId: 'old-state-id' } : {},
+        createdAt: '2025-01-15T12:00:00.000Z',
+    };
+}
+function makeCommentPayload(overrides = {}) {
+    const { action = 'create', commentId = 'comment-uuid-1', body = 'This is a comment', issueId = 'issue-uuid-1', issueIdentifier = 'SUP-100', issueTitle = 'Test Issue', issueStateName = 'Started', userId = 'user-1', userName = 'Test User', } = overrides;
+    return {
+        action,
+        type: 'Comment',
+        data: {
+            id: commentId,
+            body,
+            issue: {
+                id: issueId,
+                identifier: issueIdentifier,
+                title: issueTitle,
+                url: `https://linear.app/team/issue/${issueIdentifier}`,
+                state: { id: 'state-1', name: issueStateName, type: 'started' },
+                labels: [{ id: 'label-1', name: 'Feature' }],
+                createdAt: '2025-01-15T10:00:00.000Z',
+            },
+            user: { id: userId, name: userName },
+        },
+        createdAt: '2025-01-15T12:00:00.000Z',
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('LinearPlatformAdapter', () => {
+    let adapter;
+    let mocks;
+    beforeEach(() => {
+        const { client, mocks: m } = createMockClient();
+        mocks = m;
+        adapter = new LinearPlatformAdapter(client);
+    });
+    // ========================================================================
+    // name
+    // ========================================================================
+    it('has name "linear"', () => {
+        expect(adapter.name).toBe('linear');
+    });
+    // ========================================================================
+    // normalizeWebhookEvent — Issue updates
+    // ========================================================================
+    describe('normalizeWebhookEvent — issue updates', () => {
+        it('returns IssueStatusChangedEvent for issue update with state change', () => {
+            const payload = makeIssueUpdatePayload({ stateName: 'Started' });
+            const events = adapter.normalizeWebhookEvent(payload);
+            expect(events).not.toBeNull();
+            expect(events).toHaveLength(1);
+            const event = events[0];
+            expect(event.type).toBe('issue-status-changed');
+            expect(event.issueId).toBe('issue-uuid-1');
+            expect(event.source).toBe('webhook');
+            if (event.type === 'issue-status-changed') {
+                expect(event.newStatus).toBe('Started');
+                expect(event.issue.id).toBe('issue-uuid-1');
+                expect(event.issue.identifier).toBe('SUP-100');
+                expect(event.issue.title).toBe('Test Issue');
+                expect(event.issue.status).toBe('Started');
+                expect(event.issue.labels).toEqual(['Feature']);
+                expect(event.issue.project).toBe('MyProject');
+                expect(event.timestamp).toBeTruthy();
+            }
+        });
+        it('returns null for issue update without state change', () => {
+            const payload = makeIssueUpdatePayload({ hasStateChange: false });
+            const events = adapter.normalizeWebhookEvent(payload);
+            expect(events).toBeNull();
+        });
+        it('returns null for issue create action', () => {
+            const payload = makeIssueUpdatePayload({ action: 'create' });
+            const events = adapter.normalizeWebhookEvent(payload);
+            expect(events).toBeNull();
+        });
+        it('returns null for issue remove action', () => {
+            const payload = makeIssueUpdatePayload({ action: 'remove' });
+            const events = adapter.normalizeWebhookEvent(payload);
+            expect(events).toBeNull();
+        });
+        it('includes parentId when issue has a parent', () => {
+            const payload = makeIssueUpdatePayload({ parentId: 'parent-uuid-1' });
+            const events = adapter.normalizeWebhookEvent(payload);
+            expect(events).not.toBeNull();
+            const event = events[0];
+            if (event.type === 'issue-status-changed') {
+                expect(event.issue.parentId).toBe('parent-uuid-1');
+            }
+        });
+        it('handles issue with no description', () => {
+            const payload = makeIssueUpdatePayload();
+            // Remove description from data
+            delete payload.data.description;
+            const events = adapter.normalizeWebhookEvent(payload);
+            expect(events).not.toBeNull();
+            const event = events[0];
+            if (event.type === 'issue-status-changed') {
+                expect(event.issue.description).toBeUndefined();
+            }
+        });
+        it('handles issue with no labels', () => {
+            const payload = makeIssueUpdatePayload({ labels: [] });
+            const events = adapter.normalizeWebhookEvent(payload);
+            expect(events).not.toBeNull();
+            const event = events[0];
+            if (event.type === 'issue-status-changed') {
+                expect(event.issue.labels).toEqual([]);
+            }
+        });
+        it('parses createdAt from webhook data into milliseconds', () => {
+            const payload = makeIssueUpdatePayload({ createdAt: '2025-06-01T00:00:00.000Z' });
+            const events = adapter.normalizeWebhookEvent(payload);
+            expect(events).not.toBeNull();
+            const event = events[0];
+            if (event.type === 'issue-status-changed') {
+                expect(event.issue.createdAt).toBe(new Date('2025-06-01T00:00:00.000Z').getTime());
+            }
+        });
+    });
+    // ========================================================================
+    // normalizeWebhookEvent — Comments
+    // ========================================================================
+    describe('normalizeWebhookEvent — comments', () => {
+        it('returns CommentAddedEvent for comment creation', () => {
+            const payload = makeCommentPayload();
+            const events = adapter.normalizeWebhookEvent(payload);
+            expect(events).not.toBeNull();
+            expect(events).toHaveLength(1);
+            const event = events[0];
+            expect(event.type).toBe('comment-added');
+            expect(event.issueId).toBe('issue-uuid-1');
+            expect(event.source).toBe('webhook');
+            if (event.type === 'comment-added') {
+                expect(event.commentId).toBe('comment-uuid-1');
+                expect(event.commentBody).toBe('This is a comment');
+                expect(event.userId).toBe('user-1');
+                expect(event.userName).toBe('Test User');
+                expect(event.issue.identifier).toBe('SUP-100');
+                expect(event.issue.status).toBe('Started');
+            }
+        });
+        it('returns null for comment update action', () => {
+            const payload = makeCommentPayload({ action: 'update' });
+            const events = adapter.normalizeWebhookEvent(payload);
+            expect(events).toBeNull();
+        });
+        it('returns null for comment remove action', () => {
+            const payload = makeCommentPayload({ action: 'remove' });
+            const events = adapter.normalizeWebhookEvent(payload);
+            expect(events).toBeNull();
+        });
+        it('handles comment without user', () => {
+            const payload = makeCommentPayload();
+            delete payload.data.user;
+            const events = adapter.normalizeWebhookEvent(payload);
+            expect(events).not.toBeNull();
+            const event = events[0];
+            if (event.type === 'comment-added') {
+                expect(event.userId).toBeUndefined();
+                expect(event.userName).toBeUndefined();
+            }
+        });
+    });
+    // ========================================================================
+    // normalizeWebhookEvent — Unrecognized payloads
+    // ========================================================================
+    describe('normalizeWebhookEvent — unrecognized payloads', () => {
+        it('returns null for null payload', () => {
+            expect(adapter.normalizeWebhookEvent(null)).toBeNull();
+        });
+        it('returns null for undefined payload', () => {
+            expect(adapter.normalizeWebhookEvent(undefined)).toBeNull();
+        });
+        it('returns null for non-object payload', () => {
+            expect(adapter.normalizeWebhookEvent('string')).toBeNull();
+            expect(adapter.normalizeWebhookEvent(42)).toBeNull();
+        });
+        it('returns null for AgentSessionEvent payloads', () => {
+            const payload = {
+                action: 'created',
+                type: 'AgentSessionEvent',
+                data: { id: 'session-1' },
+            };
+            expect(adapter.normalizeWebhookEvent(payload)).toBeNull();
+        });
+        it('returns null for unknown resource types', () => {
+            const payload = {
+                action: 'update',
+                type: 'Project',
+                data: { id: 'proj-1' },
+            };
+            expect(adapter.normalizeWebhookEvent(payload)).toBeNull();
+        });
+        it('returns null for payload without data', () => {
+            const payload = {
+                action: 'update',
+                type: 'Issue',
+            };
+            expect(adapter.normalizeWebhookEvent(payload)).toBeNull();
+        });
+    });
+    // ========================================================================
+    // scanProjectIssues
+    // ========================================================================
+    describe('scanProjectIssues', () => {
+        it('returns GovernorIssues for all non-terminal issues', async () => {
+            const issues = [
+                mockLinearIssue({ id: 'i-1', identifier: 'SUP-1', stateName: 'Backlog' }),
+                mockLinearIssue({ id: 'i-2', identifier: 'SUP-2', stateName: 'Started' }),
+                mockLinearIssue({ id: 'i-3', identifier: 'SUP-3', stateName: 'Finished' }),
+            ];
+            mocks.linearClientIssues.mockResolvedValue({ nodes: issues });
+            const result = await adapter.scanProjectIssues('MyProject');
+            expect(result).toHaveLength(3);
+            expect(result[0].id).toBe('i-1');
+            expect(result[0].identifier).toBe('SUP-1');
+            expect(result[0].status).toBe('Backlog');
+            expect(result[1].id).toBe('i-2');
+            expect(result[1].status).toBe('Started');
+            expect(result[2].id).toBe('i-3');
+            expect(result[2].status).toBe('Finished');
+        });
+        it('passes correct filter to Linear API', async () => {
+            mocks.linearClientIssues.mockResolvedValue({ nodes: [] });
+            await adapter.scanProjectIssues('TestProject');
+            expect(mocks.linearClientIssues).toHaveBeenCalledWith({
+                filter: {
+                    project: { name: { eq: 'TestProject' } },
+                    state: { name: { nin: ['Accepted', 'Canceled', 'Duplicate'] } },
+                },
+            });
+        });
+        it('returns empty array when no issues found', async () => {
+            mocks.linearClientIssues.mockResolvedValue({ nodes: [] });
+            const result = await adapter.scanProjectIssues('EmptyProject');
+            expect(result).toEqual([]);
+        });
+        it('resolves lazy-loaded issue properties', async () => {
+            const issue = mockLinearIssue({
+                labels: ['Bug', 'Urgent'],
+                parentId: 'parent-1',
+                projectName: 'MyProject',
+            });
+            mocks.linearClientIssues.mockResolvedValue({ nodes: [issue] });
+            const result = await adapter.scanProjectIssues('MyProject');
+            expect(result[0].labels).toEqual(['Bug', 'Urgent']);
+            expect(result[0].parentId).toBe('parent-1');
+            expect(result[0].project).toBe('MyProject');
+        });
+        it('converts createdAt Date to epoch milliseconds', async () => {
+            const issue = mockLinearIssue({
+                createdAt: new Date('2025-03-01T08:00:00Z'),
+            });
+            mocks.linearClientIssues.mockResolvedValue({ nodes: [issue] });
+            const result = await adapter.scanProjectIssues('MyProject');
+            expect(result[0].createdAt).toBe(new Date('2025-03-01T08:00:00Z').getTime());
+        });
+    });
+    // ========================================================================
+    // toGovernorIssue
+    // ========================================================================
+    describe('toGovernorIssue', () => {
+        it('converts a Linear SDK Issue to GovernorIssue', async () => {
+            const issue = mockLinearIssue({
+                id: 'conv-1',
+                identifier: 'SUP-50',
+                title: 'Convert me',
+                description: 'Some description',
+                stateName: 'Delivered',
+                labels: ['Feature', 'Frontend'],
+                parentId: 'parent-2',
+                projectName: 'ConvertProject',
+                createdAt: new Date('2025-02-20T00:00:00Z'),
+            });
+            const result = await adapter.toGovernorIssue(issue);
+            expect(result).toEqual({
+                id: 'conv-1',
+                identifier: 'SUP-50',
+                title: 'Convert me',
+                description: 'Some description',
+                status: 'Delivered',
+                labels: ['Feature', 'Frontend'],
+                parentId: 'parent-2',
+                project: 'ConvertProject',
+                createdAt: new Date('2025-02-20T00:00:00Z').getTime(),
+            });
+        });
+        it('handles issue with no parent', async () => {
+            const issue = mockLinearIssue({ parentId: null });
+            const result = await adapter.toGovernorIssue(issue);
+            expect(result.parentId).toBeUndefined();
+        });
+        it('handles issue with no project', async () => {
+            const issue = mockLinearIssue({ projectName: null });
+            const result = await adapter.toGovernorIssue(issue);
+            expect(result.project).toBeUndefined();
+        });
+        it('handles issue with no state (defaults to Backlog)', async () => {
+            const issue = mockLinearIssue({ stateName: '' });
+            // Simulate null state
+            Object.defineProperty(issue, 'state', {
+                get: () => Promise.resolve(null),
+            });
+            const result = await adapter.toGovernorIssue(issue);
+            expect(result.status).toBe('Backlog');
+        });
+        it('handles issue with null description', async () => {
+            const issue = mockLinearIssue({ description: null });
+            const result = await adapter.toGovernorIssue(issue);
+            expect(result.description).toBeUndefined();
+        });
+        it('throws for invalid native object', async () => {
+            await expect(adapter.toGovernorIssue(null)).rejects.toThrow('expected a Linear SDK Issue object');
+        });
+        it('throws for object without id', async () => {
+            await expect(adapter.toGovernorIssue({ title: 'no id' })).rejects.toThrow('expected a Linear SDK Issue object');
+        });
+    });
+    // ========================================================================
+    // isParentIssue (inherited from LinearFrontendAdapter)
+    // ========================================================================
+    describe('isParentIssue', () => {
+        it('delegates to client.isParentIssue', async () => {
+            mocks.isParentIssue.mockResolvedValue(true);
+            const result = await adapter.isParentIssue('issue-1');
+            expect(result).toBe(true);
+            expect(mocks.isParentIssue).toHaveBeenCalledWith('issue-1');
+        });
+        it('returns false for non-parent issues', async () => {
+            mocks.isParentIssue.mockResolvedValue(false);
+            const result = await adapter.isParentIssue('leaf-issue');
+            expect(result).toBe(false);
+        });
+    });
+    // ========================================================================
+    // Inherited methods still work
+    // ========================================================================
+    describe('inherits LinearFrontendAdapter', () => {
+        it('resolveStatus works', () => {
+            expect(adapter.resolveStatus('backlog')).toBe('Backlog');
+            expect(adapter.resolveStatus('started')).toBe('Started');
+        });
+        it('abstractStatus works', () => {
+            expect(adapter.abstractStatus('Backlog')).toBe('backlog');
+            expect(adapter.abstractStatus('Finished')).toBe('finished');
+        });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supaku/agentfactory-linear",
-  "version": "0.7.10",
+  "version": "0.7.12",
   "type": "module",
   "description": "Linear issue tracker integration for AgentFactory — status transitions, agent sessions, work routing",
   "author": "Supaku (https://supaku.com)",