@stoneforge/quarry 1.10.2 → 1.13.0

package/dist/external-sync/providers/github/github-task-adapter.js

@@ -0,0 +1,374 @@
+/**
+ * GitHub Task Sync Adapter
+ *
+ * Implements TaskSyncAdapter for GitHub Issues.
+ * Uses GitHubApiClient internally for all API operations and maps between
+ * the normalized ExternalTask format and GitHub's issue representation.
+ *
+ * Project format: 'owner/repo' (e.g., 'stoneforge-ai/stoneforge')
+ * External ID format: issue number as string (e.g., '42')
+ */
+import { GitHubApiClient, isGitHubApiError } from './github-api.js';
+import { GITHUB_SYNC_LABEL_PREFIX } from './github-field-map.js';
+// ============================================================================
+// Project Parsing
+// ============================================================================
+/**
+ * Parses a project string in 'owner/repo' format into owner and repo components.
+ *
+ * @param project - Project identifier in 'owner/repo' format
+ * @returns Tuple of [owner, repo]
+ * @throws Error if the project string is not in the expected format
+ */
+function parseProject(project) {
+    const parts = project.split('/');
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+        throw new Error(`Invalid GitHub project format: '${project}'. Expected 'owner/repo' (e.g., 'stoneforge-ai/stoneforge').`);
+    }
+    return [parts[0], parts[1]];
+}
+// ============================================================================
+// GitHub Issue <-> ExternalTask Mapping
+// ============================================================================
+/**
+ * Converts a GitHub API issue response to the normalized ExternalTask format.
+ *
+ * @param issue - Raw GitHub issue from the API client
+ * @param project - The 'owner/repo' project identifier
+ * @returns Normalized ExternalTask
+ */
+function githubIssueToExternalTask(issue, project) {
+    return {
+        externalId: String(issue.number),
+        url: issue.html_url,
+        provider: 'github',
+        project,
+        title: issue.title,
+        body: issue.body ?? undefined,
+        state: issue.state,
+        labels: issue.labels.map((label) => label.name),
+        assignees: issue.assignees.map((user) => user.login),
+        createdAt: issue.created_at,
+        updatedAt: issue.updated_at,
+        closedAt: issue.closed_at ?? undefined,
+        raw: issue,
+    };
+}
+// ============================================================================
+// Label Color Defaults
+// ============================================================================
+/**
+ * Default colors for auto-created sf:* labels on GitHub repos.
+ * Colors are hex strings without '#' prefix.
+ *
+ * - Priority labels: blue shades
+ * - Type labels: green shades
+ * - Fallback: neutral gray
+ */
+const SF_LABEL_COLORS = {
+    // Priority labels — blue palette
+    'sf:priority:critical': 'b60205', // red for critical
+    'sf:priority:high': 'd93f0b', // orange-red
+    'sf:priority:medium': 'fbca04', // yellow
+    'sf:priority:low': '0e8a16', // green
+    'sf:priority:minimal': 'c5def5', // light blue
+    // Type labels — green/teal palette
+    'sf:type:bug': 'd73a4a', // red (bug convention)
+    'sf:type:feature': 'a2eeef', // teal
+    'sf:type:task': '0075ca', // blue
+    'sf:type:chore': 'e4e669', // yellow-green
+    // Status labels — distinct palette for workflow states
+    'sf:status:open': '0e8a16', // green — active
+    'sf:status:in-progress': '1d76db', // blue — working
+    'sf:status:blocked': 'e4e669', // yellow — waiting
+    'sf:status:deferred': 'c5def5', // light blue — postponed
+    'sf:status:backlog': 'd4c5f9', // lavender — queued
+    'sf:status:review': 'f9d0c4', // peach — review
+    'sf:status:closed': '5319e7', // purple — done
+    'sf:status:tombstone': 'ededed', // gray — deleted
+};
+/** Fallback color for sf:* labels not in the mapping */
+const SF_LABEL_DEFAULT_COLOR = 'ededed';
+/**
+ * Returns the default color for a given sf:* label name.
+ * Falls back to a neutral gray if no specific color is defined.
+ */
+export function getDefaultLabelColor(labelName) {
+    return SF_LABEL_COLORS[labelName] ?? SF_LABEL_DEFAULT_COLOR;
+}
+// ============================================================================
+// GitHubTaskAdapter
+// ============================================================================
+/**
+ * TaskSyncAdapter implementation for GitHub Issues.
+ *
+ * Maps between Stoneforge's normalized ExternalTask format and GitHub's
+ * issue API. Uses GitHubApiClient for all HTTP operations.
+ *
+ * Auto-creates sf:* labels on the target repository before assigning them
+ * to issues, preventing GitHub 422 "Validation Failed" errors.
+ *
+ * Usage:
+ * ```typescript
+ * const adapter = new GitHubTaskAdapter({
+ *   token: 'ghp_...',
+ *   apiBaseUrl: 'https://api.github.com', // optional
+ * });
+ *
+ * const issue = await adapter.getIssue('owner/repo', '42');
+ * const issues = await adapter.listIssuesSince('owner/repo', Date.now());
+ * ```
+ */
+export class GitHubTaskAdapter {
+    client;
+    /**
+     * Per-repo cache of known label names.
+     * Key is 'owner/repo', value is a Set of label names that exist on the repo.
+     * Populated once per repo per session to avoid redundant API calls.
+     */
+    labelCache = new Map();
+    constructor(options) {
+        this.client = new GitHubApiClient(options);
+    }
+    /**
+     * Fetch a single issue by its number.
+     *
+     * @param project - Repository in 'owner/repo' format
+     * @param externalId - GitHub issue number as a string
+     * @returns The normalized ExternalTask, or null if not found
+     */
+    async getIssue(project, externalId) {
+        const [owner, repo] = parseProject(project);
+        const issueNumber = parseInt(externalId, 10);
+        if (isNaN(issueNumber) || issueNumber <= 0) {
+            throw new Error(`Invalid GitHub issue number: '${externalId}'. Expected a positive integer.`);
+        }
+        try {
+            const issue = await this.client.getIssue(owner, repo, issueNumber);
+            return githubIssueToExternalTask(issue, project);
+        }
+        catch (error) {
+            // Return null for 404 (issue not found), rethrow other errors
+            if (isGitHubApiError(error) && error.isNotFound) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * List all issues updated since the given timestamp.
+     *
+     * Fetches all issues (open and closed) that have been updated since
+     * the provided timestamp. Uses auto-pagination to retrieve all matching
+     * issues across multiple pages.
+     *
+     * @param project - Repository in 'owner/repo' format
+     * @param since - Timestamp (milliseconds since epoch) to filter by
+     * @returns Array of normalized ExternalTask objects
+     */
+    async listIssuesSince(project, since) {
+        const [owner, repo] = parseProject(project);
+        // Convert Timestamp (ms since epoch) to ISO 8601 string
+        const sinceISO = new Date(since).toISOString();
+        const issues = await this.client.listIssues(owner, repo, {
+            since: sinceISO,
+            state: 'all',
+            per_page: 100,
+        });
+        return issues.map((issue) => githubIssueToExternalTask(issue, project));
+    }
+    /**
+     * Create a new issue in the specified repository.
+     *
+     * Maps ExternalTaskInput fields to GitHub's create issue payload:
+     * - title -> title
+     * - body -> body
+     * - labels -> labels (as label names)
+     *
+     * Note: Assignees are intentionally NOT set on created issues. Stoneforge
+     * assignees are ephemeral agents that don't correspond to GitHub users.
+     *
+     * Note: The 'state' field from ExternalTaskInput is ignored for creation
+     * since GitHub issues are always created in the 'open' state.
+     *
+     * @param project - Repository in 'owner/repo' format
+     * @param issue - The issue data to create
+     * @returns The created ExternalTask with its new external ID and URL
+     */
+    async createIssue(project, issue) {
+        const [owner, repo] = parseProject(project);
+        // Ensure sf:* labels exist on the repo before creating the issue
+        if (issue.labels && issue.labels.length > 0) {
+            await this.ensureLabelsExist(project, [...issue.labels]);
+        }
+        const created = await this.client.createIssue(owner, repo, {
+            title: issue.title,
+            body: issue.body,
+            labels: issue.labels ? [...issue.labels] : undefined,
+            // Assignees intentionally omitted — Stoneforge agents are not GitHub users
+        });
+        return githubIssueToExternalTask(created, project);
+    }
+    /**
+     * Update an existing issue in the specified repository.
+     *
+     * Maps partial ExternalTaskInput fields to GitHub's update issue payload.
+     * Only fields present in the updates object are sent to GitHub —
+     * undefined fields are left unchanged.
+     *
+     * @param project - Repository in 'owner/repo' format
+     * @param externalId - GitHub issue number as a string
+     * @param updates - Partial issue data to update
+     * @returns The updated ExternalTask
+     */
+    async updateIssue(project, externalId, updates) {
+        const [owner, repo] = parseProject(project);
+        const issueNumber = parseInt(externalId, 10);
+        if (isNaN(issueNumber) || issueNumber <= 0) {
+            throw new Error(`Invalid GitHub issue number: '${externalId}'. Expected a positive integer.`);
+        }
+        // Ensure sf:* labels exist on the repo before updating the issue
+        if (updates.labels !== undefined && updates.labels.length > 0) {
+            await this.ensureLabelsExist(project, [...updates.labels]);
+        }
+        // Build the update payload, only including defined fields
+        const payload = {};
+        if (updates.title !== undefined) {
+            payload.title = updates.title;
+        }
+        if (updates.body !== undefined) {
+            payload.body = updates.body;
+        }
+        if (updates.state !== undefined) {
+            payload.state = updates.state;
+        }
+        if (updates.labels !== undefined) {
+            payload.labels = [...updates.labels];
+        }
+        // Assignees intentionally omitted — Stoneforge agents are not GitHub users
+        const updated = await this.client.updateIssue(owner, repo, issueNumber, payload);
+        return githubIssueToExternalTask(updated, project);
+    }
+    /**
+     * Ensures that all sf:* labels in the given list exist on the target repository.
+     *
+     * For each label with the sync prefix (sf:), checks the per-repo cache first.
+     * If the cache hasn't been populated yet, fetches all labels from the repo once.
+     * Any missing sf:* labels are created with sensible default colors.
+     *
+     * Non-sf:* labels (user-managed) are not checked or created — those are the
+     * user's responsibility.
+     *
+     * @param project - Repository in 'owner/repo' format
+     * @param labels - Array of label names that will be assigned to an issue
+     */
+    async ensureLabelsExist(project, labels) {
+        const sfLabels = labels.filter((l) => l.startsWith(GITHUB_SYNC_LABEL_PREFIX));
+        if (sfLabels.length === 0)
+            return;
+        const [owner, repo] = parseProject(project);
+        // Populate cache if this is the first time we're checking this repo
+        if (!this.labelCache.has(project)) {
+            const existingLabels = await this.client.getLabels(owner, repo);
+            this.labelCache.set(project, new Set(existingLabels.map((l) => l.name)));
+        }
+        const knownLabels = this.labelCache.get(project);
+        // Create any missing sf:* labels
+        for (const labelName of sfLabels) {
+            if (knownLabels.has(labelName))
+                continue;
+            const color = getDefaultLabelColor(labelName);
+            try {
+                await this.client.createLabel(owner, repo, {
+                    name: labelName,
+                    color,
+                    description: `Stoneforge sync label`,
+                });
+                knownLabels.add(labelName);
+            }
+            catch (error) {
+                // If the label was created concurrently (422 with "already_exists"),
+                // just add it to the cache and continue
+                if (isGitHubApiError(error) &&
+                    error.status === 422 &&
+                    error.responseBody?.errors &&
+                    Array.isArray(error.responseBody.errors) &&
+                    error.responseBody.errors.some((e) => e.code === 'already_exists')) {
+                    knownLabels.add(labelName);
+                    continue;
+                }
+                throw error;
+            }
+        }
+    }
+    /**
+     * Returns the GitHub-specific field mapping configuration.
+     *
+     * This configuration is used by the shared task sync adapter utilities
+     * to map between Stoneforge task fields and GitHub issue fields.
+     *
+     * The returned TaskFieldMapConfig describes individual field mappings
+     * with their directions and transform function names.
+     *
+     * @returns TaskFieldMapConfig for GitHub
+     */
+    getFieldMapConfig() {
+        return {
+            provider: 'github',
+            fields: [
+                {
+                    localField: 'title',
+                    externalField: 'title',
+                    direction: 'bidirectional',
+                },
+                {
+                    localField: 'descriptionRef',
+                    externalField: 'body',
+                    direction: 'bidirectional',
+                    toExternal: 'hydrateDescription',
+                    toLocal: 'createDescriptionDoc',
+                },
+                {
+                    localField: 'status',
+                    externalField: 'state',
+                    direction: 'bidirectional',
+                    toExternal: 'statusToGitHubState',
+                    toLocal: 'gitHubStateToStatus',
+                },
+                {
+                    localField: 'tags',
+                    externalField: 'labels',
+                    direction: 'bidirectional',
+                },
+                {
+                    localField: 'priority',
+                    externalField: 'labels',
+                    direction: 'bidirectional',
+                    toExternal: 'priorityToLabel',
+                    toLocal: 'labelToPriority',
+                },
+                {
+                    localField: 'taskType',
+                    externalField: 'labels',
+                    direction: 'bidirectional',
+                    toExternal: 'taskTypeToLabel',
+                    toLocal: 'labelToTaskType',
+                },
+                {
+                    localField: 'assignee',
+                    externalField: 'assignees',
+                    direction: 'pull',
+                },
+            ],
+        };
+    }
+}
+/**
+ * Returns the GitHub-specific TaskSyncFieldMapConfig for use with
+ * the shared task sync adapter utilities.
+ *
+ * This is a convenience export for code that needs the config directly
+ * without going through the adapter's getFieldMapConfig() method.
+ */
+export { GITHUB_FIELD_MAP_CONFIG } from './github-field-map.js';
+//# sourceMappingURL=github-task-adapter.js.map

package/dist/external-sync/providers/github/github-task-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-task-adapter.js","sourceRoot":"","sources":["../../../../src/external-sync/providers/github/github-task-adapter.ts"],"names":[],"mappings":"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"}

package/dist/external-sync/providers/github/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * GitHub Provider — exports for the GitHub external sync provider
+ *
+ * Exports the full GitHub provider implementation, task adapter,
+ * field mapping configuration, and API client.
+ */
+export { createGitHubProvider, createGitHubPlaceholderProvider } from './github-provider.js';
+export { GitHubTaskAdapter, getDefaultLabelColor } from './github-task-adapter.js';
+export { GITHUB_FIELD_MAP_CONFIG, GITHUB_PRIORITY_LABELS, GITHUB_TASK_TYPE_LABELS, GITHUB_SYNC_LABEL_PREFIX, statusToGitHubState, gitHubStateToStatus, } from './github-field-map.js';
+export { GitHubApiClient, GitHubApiError, isGitHubApiError } from './github-api.js';
+export type { GitHubIssue, GitHubLabel, GitHubUser, GitHubApiClientOptions, ListIssuesOptions, CreateIssueInput, CreateLabelInput, UpdateIssueInput, RateLimitInfo, } from './github-api.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/external-sync/providers/github/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/external-sync/providers/github/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AAG7F,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGnF,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpF,YAAY,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,iBAAiB,CAAC"}

package/dist/external-sync/providers/github/index.js

@@ -0,0 +1,15 @@
+/**
+ * GitHub Provider — exports for the GitHub external sync provider
+ *
+ * Exports the full GitHub provider implementation, task adapter,
+ * field mapping configuration, and API client.
+ */
+// Provider factories
+export { createGitHubProvider, createGitHubPlaceholderProvider } from './github-provider.js';
+// Task adapter
+export { GitHubTaskAdapter, getDefaultLabelColor } from './github-task-adapter.js';
+// Field mapping configuration
+export { GITHUB_FIELD_MAP_CONFIG, GITHUB_PRIORITY_LABELS, GITHUB_TASK_TYPE_LABELS, GITHUB_SYNC_LABEL_PREFIX, statusToGitHubState, gitHubStateToStatus, } from './github-field-map.js';
+// API client (re-export for convenience)
+export { GitHubApiClient, GitHubApiError, isGitHubApiError } from './github-api.js';
+//# sourceMappingURL=index.js.map

package/dist/external-sync/providers/github/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/external-sync/providers/github/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAqB;AACrB,OAAO,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AAE7F,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,8BAA8B;AAC9B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,yCAAyC;AACzC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/external-sync/providers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * External Sync Providers — barrel exports for all provider implementations
+ *
+ * Re-exports provider factory functions and key types from each provider module.
+ */
+export { createGitHubPlaceholderProvider } from './github/index.js';
+export { createLinearProvider, createLinearPlaceholderProvider, } from './linear/index.js';
+export type { CreateLinearProviderOptions } from './linear/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/external-sync/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/external-sync/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAGpE,OAAO,EACL,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/external-sync/providers/index.js

@@ -0,0 +1,10 @@
+/**
+ * External Sync Providers — barrel exports for all provider implementations
+ *
+ * Re-exports provider factory functions and key types from each provider module.
+ */
+// GitHub provider
+export { createGitHubPlaceholderProvider } from './github/index.js';
+// Linear provider
+export { createLinearProvider, createLinearPlaceholderProvider, } from './linear/index.js';
+//# sourceMappingURL=index.js.map

package/dist/external-sync/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/external-sync/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kBAAkB;AAClB,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAEpE,kBAAkB;AAClB,OAAO,EACL,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,mBAAmB,CAAC"}

package/dist/external-sync/providers/linear/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Linear Provider — exports for the Linear external sync provider
+ *
+ * Provides:
+ * - LinearApiClient: GraphQL API client for Linear
+ * - LinearTaskAdapter: TaskSyncAdapter implementation for Linear issues
+ * - LinearProvider: ExternalProvider implementation (via factory functions)
+ * - Field mapping utilities for priority and workflow state conversion
+ * - Linear API response types
+ */
+export { createLinearProvider, createLinearPlaceholderProvider, } from './linear-provider.js';
+export type { CreateLinearProviderOptions } from './linear-provider.js';
+export { LinearTaskAdapter } from './linear-task-adapter.js';
+export { stoneforgePriorityToLinear, linearPriorityToStoneforge, linearStateTypeToStatus, statusToLinearStateType, shouldAddBlockedLabel, createLinearFieldMapConfig, createLinearSyncFieldMapConfig, } from './linear-field-map.js';
+export type { LinearStateType } from './linear-field-map.js';
+export { LinearApiClient, LinearApiError, isLinearApiError } from './linear-api.js';
+export type { LinearApiClientOptions, RateLimitInfo, GraphQLError, CreateIssueInput, UpdateIssueInput, } from './linear-api.js';
+export type { LinearIssue, LinearTeam, LinearUser, LinearLabel, LinearWorkflowState, LinearPageInfo, LinearConnection, } from './linear-types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/external-sync/providers/linear/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/external-sync/providers/linear/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAGxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpF,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/external-sync/providers/linear/index.js

@@ -0,0 +1,19 @@
+/**
+ * Linear Provider — exports for the Linear external sync provider
+ *
+ * Provides:
+ * - LinearApiClient: GraphQL API client for Linear
+ * - LinearTaskAdapter: TaskSyncAdapter implementation for Linear issues
+ * - LinearProvider: ExternalProvider implementation (via factory functions)
+ * - Field mapping utilities for priority and workflow state conversion
+ * - Linear API response types
+ */
+// Provider factory functions
+export { createLinearProvider, createLinearPlaceholderProvider, } from './linear-provider.js';
+// Task adapter
+export { LinearTaskAdapter } from './linear-task-adapter.js';
+// Field mapping
+export { stoneforgePriorityToLinear, linearPriorityToStoneforge, linearStateTypeToStatus, statusToLinearStateType, shouldAddBlockedLabel, createLinearFieldMapConfig, createLinearSyncFieldMapConfig, } from './linear-field-map.js';
+// API client
+export { LinearApiClient, LinearApiError, isLinearApiError } from './linear-api.js';
+//# sourceMappingURL=index.js.map

package/dist/external-sync/providers/linear/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/external-sync/providers/linear/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,6BAA6B;AAC7B,OAAO,EACL,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,sBAAsB,CAAC;AAG9B,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,gBAAgB;AAChB,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,uBAAuB,CAAC;AAG/B,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}