@stoneforge/quarry 1.12.0 → 1.14.0

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

@@ -0,0 +1,338 @@
+/**
+ * Linear Field Mapping Configuration
+ *
+ * Defines how Stoneforge task fields map to Linear issue fields.
+ *
+ * Key differences from GitHub:
+ * - Linear has native priority (0-4) — no label-based priority convention needed
+ * - Linear has workflow state types — status mapping uses state types, not labels
+ * - Task types use the same label convention as GitHub (type:bug, etc.)
+ *
+ * Priority mapping (Linear 0-4 ↔ Stoneforge 1-5):
+ *   Linear 1 (Urgent)      ↔ Stoneforge 1 (critical)
+ *   Linear 2 (High)        ↔ Stoneforge 2 (high)
+ *   Linear 3 (Medium)      ↔ Stoneforge 3 (medium)
+ *   Linear 4 (Low)         ↔ Stoneforge 4 (low)
+ *   Linear 0 (No priority) ↔ Stoneforge 5 (minimal)
+ *
+ * Status mapping via workflow state TYPE (not name):
+ *   Pull: triage/backlog → backlog, unstarted → open, started → in_progress,
+ *         completed → closed, canceled → closed (closeReason: "canceled")
+ *   Push: open → unstarted, in_progress/review → started,
+ *         blocked → started (add "blocked" label), deferred/backlog → backlog,
+ *         closed → completed
+ */
+// ============================================================================
+// Status Label Mapping (for adapter-injected status labels)
+// ============================================================================
+/**
+ * Maps Stoneforge TaskStatus values to label strings.
+ * Linear doesn't natively use label-based status, but the adapter injects
+ * sf:status:* labels into ExternalTask.labels to communicate granular workflow
+ * state types through the generic field mapping system.
+ *
+ * This keeps the sync engine provider-agnostic — it reads status from labels
+ * the same way for both GitHub (user-managed labels) and Linear (adapter-injected).
+ */
+export const LINEAR_STATUS_LABELS = {
+    open: 'status:open',
+    in_progress: 'status:in-progress',
+    blocked: 'status:blocked',
+    deferred: 'status:deferred',
+    backlog: 'status:backlog',
+    review: 'status:review',
+    closed: 'status:closed',
+    tombstone: 'status:tombstone',
+};
+// ============================================================================
+// Priority Mapping
+// ============================================================================
+/**
+ * Maps Stoneforge priority (1-5) to Linear priority (0-4).
+ *
+ * Stoneforge 1 (critical) → Linear 1 (Urgent)
+ * Stoneforge 2 (high)     → Linear 2 (High)
+ * Stoneforge 3 (medium)   → Linear 3 (Medium)
+ * Stoneforge 4 (low)      → Linear 4 (Low)
+ * Stoneforge 5 (minimal)  → Linear 0 (No priority)
+ */
+export function stoneforgePriorityToLinear(priority) {
+    switch (priority) {
+        case 1:
+            return 1; // critical → Urgent
+        case 2:
+            return 2; // high → High
+        case 3:
+            return 3; // medium → Medium
+        case 4:
+            return 4; // low → Low
+        case 5:
+            return 0; // minimal → No priority
+        default:
+            return 3; // fallback: Medium
+    }
+}
+/**
+ * Maps Linear priority (0-4) to Stoneforge priority (1-5).
+ *
+ * Linear 1 (Urgent)      → Stoneforge 1 (critical)
+ * Linear 2 (High)        → Stoneforge 2 (high)
+ * Linear 3 (Medium)      → Stoneforge 3 (medium)
+ * Linear 4 (Low)         → Stoneforge 4 (low)
+ * Linear 0 (No priority) → Stoneforge 5 (minimal)
+ */
+export function linearPriorityToStoneforge(priority) {
+    switch (priority) {
+        case 1:
+            return 1; // Urgent → critical
+        case 2:
+            return 2; // High → high
+        case 3:
+            return 3; // Medium → medium
+        case 4:
+            return 4; // Low → low
+        case 0:
+            return 5; // No priority → minimal
+        default:
+            return 3; // fallback: medium
+    }
+}
+/**
+ * Maps a Linear workflow state type to a Stoneforge TaskStatus.
+ *
+ * Pull direction:
+ *   triage    → backlog
+ *   backlog   → backlog
+ *   unstarted → open
+ *   started   → in_progress
+ *   completed → closed
+ *   canceled  → closed
+ */
+export function linearStateTypeToStatus(stateType) {
+    switch (stateType) {
+        case 'triage':
+            return { status: 'backlog' };
+        case 'backlog':
+            return { status: 'backlog' };
+        case 'unstarted':
+            return { status: 'open' };
+        case 'started':
+            return { status: 'in_progress' };
+        case 'completed':
+            return { status: 'closed' };
+        case 'canceled':
+            return { status: 'closed', closeReason: 'canceled' };
+        default:
+            return { status: 'open' };
+    }
+}
+/**
+ * Maps a Stoneforge TaskStatus to a Linear workflow state type.
+ *
+ * Push direction:
+ *   open        → unstarted
+ *   in_progress → started
+ *   review      → started
+ *   blocked     → started (caller should add "blocked" label)
+ *   deferred    → backlog
+ *   backlog     → backlog
+ *   closed      → completed
+ *   tombstone   → completed (treat as done)
+ */
+export function statusToLinearStateType(status) {
+    switch (status) {
+        case 'open':
+            return 'unstarted';
+        case 'in_progress':
+            return 'started';
+        case 'review':
+            return 'started';
+        case 'blocked':
+            return 'started';
+        case 'deferred':
+            return 'backlog';
+        case 'backlog':
+            return 'backlog';
+        case 'closed':
+            return 'completed';
+        case 'tombstone':
+            return 'completed';
+        default:
+            return 'unstarted';
+    }
+}
+/**
+ * Returns true if the given Stoneforge status should add a "blocked" label
+ * in Linear (since Linear has no native blocked state).
+ */
+export function shouldAddBlockedLabel(status) {
+    return status === 'blocked';
+}
+/**
+ * Maps a Linear workflow state type to a sync label string (sf:status:*).
+ *
+ * The Linear adapter injects this label into ExternalTask.labels so the
+ * generic field mapping system (stateToStatus) can extract granular statuses
+ * without the sync engine needing to know about Linear-specific state types.
+ *
+ * Mapping:
+ *   triage    → sf:status:backlog
+ *   backlog   → sf:status:backlog
+ *   unstarted → sf:status:open
+ *   started   → sf:status:in-progress
+ *   completed → sf:status:closed
+ *   canceled  → sf:status:closed
+ */
+export function linearStateTypeToStatusLabel(stateType) {
+    switch (stateType) {
+        case 'triage':
+            return 'sf:status:backlog';
+        case 'backlog':
+            return 'sf:status:backlog';
+        case 'unstarted':
+            return 'sf:status:open';
+        case 'started':
+            return 'sf:status:in-progress';
+        case 'completed':
+            return 'sf:status:closed';
+        case 'canceled':
+            return 'sf:status:closed';
+        default:
+            return 'sf:status:open';
+    }
+}
+// ============================================================================
+// TaskFieldMapConfig (for TaskSyncAdapter.getFieldMapConfig())
+// ============================================================================
+/**
+ * Creates the Linear-specific TaskFieldMapConfig.
+ *
+ * This config describes the field mapping at the type level. The actual
+ * runtime mapping logic lives in the adapter and the priority/status
+ * functions above.
+ */
+export function createLinearFieldMapConfig() {
+    return {
+        provider: 'linear',
+        fields: [
+            {
+                localField: 'title',
+                externalField: 'title',
+                direction: 'bidirectional',
+            },
+            {
+                localField: 'descriptionRef',
+                externalField: 'description',
+                direction: 'bidirectional',
+                toExternal: 'hydrateDescription',
+                toLocal: 'createDescriptionDoc',
+            },
+            {
+                localField: 'status',
+                externalField: 'state',
+                direction: 'bidirectional',
+                toExternal: 'statusToLinearState',
+                toLocal: 'linearStateToStatus',
+            },
+            {
+                localField: 'priority',
+                externalField: 'priority',
+                direction: 'bidirectional',
+                toExternal: 'stoneforgePriorityToLinear',
+                toLocal: 'linearPriorityToStoneforge',
+            },
+            {
+                localField: 'tags',
+                externalField: 'labels',
+                direction: 'bidirectional',
+            },
+            {
+                localField: 'taskType',
+                externalField: 'labels',
+                direction: 'bidirectional',
+                toExternal: 'taskTypeToLabel',
+                toLocal: 'labelToTaskType',
+            },
+            {
+                localField: 'assignee',
+                externalField: 'assignee',
+                direction: 'bidirectional',
+            },
+        ],
+    };
+}
+// ============================================================================
+// TaskSyncFieldMapConfig (for shared adapter utilities)
+// ============================================================================
+/**
+ * Creates the Linear-specific TaskSyncFieldMapConfig used by the shared
+ * task-sync-adapter utilities (taskToExternalTask, externalTaskToTaskUpdates).
+ *
+ * Priority labels are emitted alongside Linear's native priority field for
+ * lossless round-tripping. This ensures the exact Stoneforge priority value
+ * is preserved (e.g., P5 "minimal" is distinct from Linear's "No priority").
+ *
+ * Status mapping uses adapter-injected sf:status:* labels. The Linear adapter
+ * injects these labels based on the workflow state type (e.g., started →
+ * sf:status:in-progress), allowing the generic stateToStatus function to
+ * extract granular statuses without coupling the sync engine to Linear.
+ */
+export function createLinearSyncFieldMapConfig() {
+    return {
+        // Priority labels for lossless round-tripping. These are synced as Linear
+        // labels alongside the native priority field, so the exact Stoneforge
+        // priority value is preserved on round-trip.
+        priorityLabels: {
+            1: 'priority:critical',
+            2: 'priority:high',
+            3: 'priority:medium',
+            4: 'priority:low',
+            5: 'priority:minimal',
+        },
+        taskTypeLabels: {
+            bug: 'type:bug',
+            feature: 'type:feature',
+            task: 'type:task',
+            chore: 'type:chore',
+        },
+        // Status labels for reading adapter-injected sf:status:* labels on pull.
+        // The Linear adapter injects these labels based on workflow state type,
+        // so parseExternalLabels() and stateToStatus() can extract granular statuses.
+        statusLabels: LINEAR_STATUS_LABELS,
+        syncLabelPrefix: 'sf:',
+        statusToState: (status) => {
+            // For the shared adapter utility, we still need open/closed.
+            // The actual state type mapping is handled by the adapter.
+            switch (status) {
+                case 'closed':
+                case 'tombstone':
+                    return 'closed';
+                default:
+                    return 'open';
+            }
+        },
+        stateToStatus: (state, labels) => {
+            // Check for adapter-injected sf:status:* labels first.
+            // The Linear adapter injects these based on workflow state type
+            // (e.g., started → sf:status:in-progress), giving us granular status
+            // without coupling the sync engine to Linear-specific state types.
+            const statusByLabel = new Map();
+            for (const [status, label] of Object.entries(LINEAR_STATUS_LABELS)) {
+                statusByLabel.set(label, status);
+            }
+            const prefix = 'sf:';
+            for (const label of labels) {
+                if (label.startsWith(prefix)) {
+                    const value = label.slice(prefix.length);
+                    const matchedStatus = statusByLabel.get(value);
+                    if (matchedStatus !== undefined) {
+                        return matchedStatus;
+                    }
+                }
+            }
+            // Fallback: basic open/closed mapping when no status label is present
+            return state === 'closed' ? 'closed' : 'open';
+        },
+    };
+}
+//# sourceMappingURL=linear-field-map.js.map

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

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

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

@@ -0,0 +1,52 @@
+/**
+ * Linear External Provider
+ *
+ * Implements the ExternalProvider interface for Linear.
+ * Handles connection validation and provides access to the LinearTaskAdapter.
+ *
+ * Architecture:
+ * - Provider handles auth configuration and connection testing
+ * - Task adapter handles issue CRUD operations and field mapping
+ * - API client handles GraphQL requests and rate limiting
+ *
+ * @example
+ * ```typescript
+ * const provider = createLinearProvider({ apiKey: 'lin_api_...' });
+ * const registry = createProviderRegistry();
+ * registry.register(provider);
+ *
+ * // Test connection
+ * const connected = await provider.testConnection({ provider: 'linear', token: 'lin_api_...' });
+ *
+ * // Get task adapter
+ * const adapter = provider.getTaskAdapter();
+ * const issues = await adapter.listIssuesSince('ENG', '2024-01-01T00:00:00Z');
+ * ```
+ */
+import type { ExternalProvider } from '@stoneforge/core';
+/**
+ * Options for creating a Linear provider.
+ */
+export interface CreateLinearProviderOptions {
+    /** Linear API key for authentication */
+    apiKey: string;
+}
+/**
+ * Create a Linear ExternalProvider.
+ *
+ * The provider is fully configured with the given API key and ready
+ * for registration in the provider registry.
+ *
+ * @param options - Configuration including the API key
+ * @returns A configured Linear ExternalProvider
+ */
+export declare function createLinearProvider(options: CreateLinearProviderOptions): ExternalProvider;
+/**
+ * Create a placeholder Linear provider for registry registration.
+ *
+ * Similar to the GitHub placeholder — registers the provider shape so the
+ * registry knows Linear is available. Connection testing always returns false.
+ * The actual provider is created with createLinearProvider() when configured.
+ */
+export declare function createLinearPlaceholderProvider(): ExternalProvider;
+//# sourceMappingURL=linear-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linear-provider.d.ts","sourceRoot":"","sources":["../../../../src/external-sync/providers/linear/linear-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAIjB,MAAM,kBAAkB,CAAC;AAsE1B;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,gBAAgB,CAG3F;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,IAAI,gBAAgB,CAElE"}

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

@@ -0,0 +1,169 @@
+/**
+ * Linear External Provider
+ *
+ * Implements the ExternalProvider interface for Linear.
+ * Handles connection validation and provides access to the LinearTaskAdapter.
+ *
+ * Architecture:
+ * - Provider handles auth configuration and connection testing
+ * - Task adapter handles issue CRUD operations and field mapping
+ * - API client handles GraphQL requests and rate limiting
+ *
+ * @example
+ * ```typescript
+ * const provider = createLinearProvider({ apiKey: 'lin_api_...' });
+ * const registry = createProviderRegistry();
+ * registry.register(provider);
+ *
+ * // Test connection
+ * const connected = await provider.testConnection({ provider: 'linear', token: 'lin_api_...' });
+ *
+ * // Get task adapter
+ * const adapter = provider.getTaskAdapter();
+ * const issues = await adapter.listIssuesSince('ENG', '2024-01-01T00:00:00Z');
+ * ```
+ */
+import { LinearApiClient } from './linear-api.js';
+import { LinearTaskAdapter } from './linear-task-adapter.js';
+// ============================================================================
+// LinearProvider
+// ============================================================================
+/**
+ * ExternalProvider implementation for Linear.
+ *
+ * Supports task sync only. Connection testing uses the getViewer() API call
+ * to verify the API key is valid.
+ */
+class LinearProvider {
+    name = 'linear';
+    displayName = 'Linear';
+    supportedAdapters = ['task'];
+    taskAdapter;
+    constructor(api) {
+        this.taskAdapter = new LinearTaskAdapter(api);
+    }
+    /**
+     * Test whether the connection to Linear is valid.
+     *
+     * Calls getViewer() to verify the API key works. The config parameter
+     * provides the token for providers that are configured dynamically,
+     * but this provider was constructed with a client already.
+     *
+     * @param _config - Provider configuration (token is already set in client)
+     * @returns true if the connection is valid, false otherwise
+     */
+    async testConnection(_config) {
+        try {
+            // Use a temporary client if config provides a different token,
+            // or fall back to testing the existing adapter's connection
+            const viewer = await this.getApiClient().getViewer();
+            return viewer !== null && viewer !== undefined;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Returns the task sync adapter.
+     */
+    getTaskAdapter() {
+        return this.taskAdapter;
+    }
+    /**
+     * Access the underlying API client (used internally for connection testing).
+     */
+    getApiClient() {
+        // The API client is encapsulated in the task adapter.
+        // For connection testing, we construct a minimal client inline.
+        // This is a workaround; in the full implementation, the provider
+        // would hold a direct reference to the client.
+        return this.taskAdapter.api;
+    }
+}
+/**
+ * Create a Linear ExternalProvider.
+ *
+ * The provider is fully configured with the given API key and ready
+ * for registration in the provider registry.
+ *
+ * @param options - Configuration including the API key
+ * @returns A configured Linear ExternalProvider
+ */
+export function createLinearProvider(options) {
+    const api = new LinearApiClient({ apiKey: options.apiKey });
+    return new LinearProvider(api);
+}
+/**
+ * Create a placeholder Linear provider for registry registration.
+ *
+ * Similar to the GitHub placeholder — registers the provider shape so the
+ * registry knows Linear is available. Connection testing always returns false.
+ * The actual provider is created with createLinearProvider() when configured.
+ */
+export function createLinearPlaceholderProvider() {
+    return new LinearPlaceholderProvider();
+}
+// ============================================================================
+// Placeholder Provider (for default registry)
+// ============================================================================
+const PLACEHOLDER_MESSAGE = 'Linear task sync adapter is not yet configured. Set a Linear API key to enable sync.';
+/**
+ * Placeholder TaskSyncAdapter for Linear.
+ * All methods throw to indicate they are not yet configured.
+ */
+class LinearPlaceholderTaskAdapter {
+    async getIssue(_project, _externalId) {
+        throw new Error(PLACEHOLDER_MESSAGE);
+    }
+    async listIssuesSince(_project, _since) {
+        throw new Error(PLACEHOLDER_MESSAGE);
+    }
+    async createIssue(_project, _issue) {
+        throw new Error(PLACEHOLDER_MESSAGE);
+    }
+    async updateIssue(_project, _externalId, _updates) {
+        throw new Error(PLACEHOLDER_MESSAGE);
+    }
+    getFieldMapConfig() {
+        // Return the field map config even in placeholder mode
+        // so the system can introspect the mapping shape
+        return {
+            provider: 'linear',
+            fields: [
+                {
+                    localField: 'title',
+                    externalField: 'title',
+                    direction: 'bidirectional',
+                },
+                {
+                    localField: 'status',
+                    externalField: 'state',
+                    direction: 'bidirectional',
+                },
+                {
+                    localField: 'priority',
+                    externalField: 'priority',
+                    direction: 'bidirectional',
+                },
+            ],
+        };
+    }
+}
+/**
+ * Placeholder Linear ExternalProvider.
+ * Declares Linear as a known provider that supports task sync.
+ * Connection testing always returns false (not configured).
+ */
+class LinearPlaceholderProvider {
+    name = 'linear';
+    displayName = 'Linear';
+    supportedAdapters = ['task'];
+    taskAdapter = new LinearPlaceholderTaskAdapter();
+    async testConnection(_config) {
+        return false;
+    }
+    getTaskAdapter() {
+        return this.taskAdapter;
+    }
+}
+//# sourceMappingURL=linear-provider.js.map

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

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