@pennyfarthing/core 7.0.1 → 7.4.0

package/dist/jira/jira-epic-creation.test.js

@@ -0,0 +1,387 @@
+/**
+ * Tests for Story 47-1: Auto-create Jira epic on local epic creation
+ *
+ * These tests define the contract for automatically creating Jira epics
+ * when SM setup detects an epic without a jira field in sprint YAML.
+ *
+ * Acceptance Criteria:
+ * 1. SM setup detects new epic without jira field
+ * 2. Automatically creates Jira epic with matching title/description
+ * 3. Updates sprint YAML with new Jira key
+ * 4. Epic number derived from Jira ticket number
+ *
+ * Run with: npm test
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { mkdirSync, rmSync, existsSync, writeFileSync, readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// Get directory for test fixtures
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEST_DIR = join(__dirname, '__test_jira_epic_creation__');
+// Import the jira epic creation functions (to be implemented)
+import { createEpicInJira, ensureEpicHasJiraKey, extractEpicNumberFromJiraKey, updateSprintYamlWithJiraKey } from './jira-epic-creation.js';
+describe('Jira Epic Creation (47-1)', () => {
+    beforeEach(() => {
+        if (existsSync(TEST_DIR)) {
+            rmSync(TEST_DIR, { recursive: true });
+        }
+        mkdirSync(TEST_DIR, { recursive: true });
+    });
+    afterEach(() => {
+        if (existsSync(TEST_DIR)) {
+            rmSync(TEST_DIR, { recursive: true });
+        }
+    });
+    describe('createEpicInJira() - Create epic in Jira', () => {
+        it('should create epic with title and description', async () => {
+            // AC2: Automatically creates Jira epic with matching title/description
+            const result = await createEpicInJira({
+                title: 'Test Epic',
+                description: 'This is a test epic for automated creation',
+                labels: ['pennyfarthing'],
+                // Mock mode for testing without real Jira
+                _mockResponse: {
+                    key: 'MSSCI-12345',
+                    url: 'https://1898andco.atlassian.net/browse/MSSCI-12345'
+                }
+            });
+            assert.strictEqual(result.success, true, 'Creation should succeed');
+            assert.ok(result.jiraKey, 'Should return Jira key');
+            assert.strictEqual(result.jiraKey, 'MSSCI-12345');
+            assert.ok(result.url, 'Should return URL');
+        });
+        it('should format epic title with epic number prefix', async () => {
+            // AC2: Epic title should include epic number for clarity
+            const result = await createEpicInJira({
+                epicNumber: 47,
+                title: 'Jira-Pennyfarthing Sync Improvements',
+                description: 'Improve sync between Jira and Pennyfarthing sprint YAML',
+                labels: ['pennyfarthing'],
+                _mockResponse: { key: 'MSSCI-11798' }
+            });
+            assert.strictEqual(result.success, true);
+            // The formatted title should be passed to Jira
+            assert.ok(result.formattedTitle?.includes('Epic 47'), 'Title should include epic number');
+        });
+        it('should include pennyfarthing label by default', async () => {
+            const result = await createEpicInJira({
+                title: 'Test Epic',
+                description: 'Test description',
+                _mockResponse: { key: 'MSSCI-12345' }
+            });
+            assert.strictEqual(result.success, true);
+            assert.ok(result.labels?.includes('pennyfarthing'), 'Should include pennyfarthing label');
+        });
+        it('should handle Jira API errors gracefully', async () => {
+            const result = await createEpicInJira({
+                title: 'Test Epic',
+                description: 'Test description',
+                _mockError: 'Connection refused'
+            });
+            assert.strictEqual(result.success, false);
+            assert.ok(result.error, 'Should have error message');
+            assert.ok(result.error?.includes('Connection'), 'Error should be descriptive');
+        });
+        it('should support dry-run mode', async () => {
+            const result = await createEpicInJira({
+                title: 'Dry Run Epic',
+                description: 'This should not actually be created',
+                dryRun: true
+            });
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.dryRun, true);
+            assert.ok(!result.jiraKey, 'Should not have real Jira key in dry-run');
+        });
+    });
+    describe('ensureEpicHasJiraKey() - Check and create if missing', () => {
+        it('should return existing jira key without creating', async () => {
+            // AC1: SM setup detects new epic without jira field
+            // This tests the "has jira field" case
+            const epic = {
+                id: 'epic-35',
+                title: 'Cyclist UI/UX Improvements',
+                jira: 'MSSCI-11715'
+            };
+            const result = await ensureEpicHasJiraKey({
+                epic,
+                _mockResponse: { key: 'MSSCI-99999' } // Should not be used
+            });
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.jiraKey, 'MSSCI-11715', 'Should return existing key');
+            assert.strictEqual(result.created, false, 'Should not have created new epic');
+        });
+        it('should create Jira epic when jira field is missing', async () => {
+            // AC1: SM setup detects new epic without jira field
+            // AC2: Automatically creates Jira epic
+            const epic = {
+                id: 'epic-48',
+                title: 'New Feature Epic',
+                // No jira field!
+            };
+            const result = await ensureEpicHasJiraKey({
+                epic,
+                _mockResponse: { key: 'MSSCI-11850' }
+            });
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.jiraKey, 'MSSCI-11850');
+            assert.strictEqual(result.created, true, 'Should indicate epic was created');
+        });
+        it('should handle empty string jira field as missing', async () => {
+            const epic = {
+                id: 'epic-49',
+                title: 'Empty Jira Field Epic',
+                jira: '' // Empty string should be treated as missing
+            };
+            const result = await ensureEpicHasJiraKey({
+                epic,
+                _mockResponse: { key: 'MSSCI-11851' }
+            });
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.created, true, 'Empty jira field should trigger creation');
+        });
+        it('should handle null jira field as missing', async () => {
+            const epic = {
+                id: 'epic-50',
+                title: 'Null Jira Field Epic',
+                jira: null // Null should be treated as missing
+            };
+            const result = await ensureEpicHasJiraKey({
+                epic,
+                _mockResponse: { key: 'MSSCI-11852' }
+            });
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.created, true, 'Null jira field should trigger creation');
+        });
+        it('should extract epic number from id for title formatting', async () => {
+            const epic = {
+                id: 'epic-47', // Contains the epic number
+                title: 'Jira-Pennyfarthing Sync Improvements'
+            };
+            const result = await ensureEpicHasJiraKey({
+                epic,
+                _mockResponse: { key: 'MSSCI-11853' }
+            });
+            assert.strictEqual(result.success, true);
+            // Should have used epic number 47 in the title
+            assert.ok(result.formattedTitle?.includes('47'), 'Should extract and use epic number from id');
+        });
+        it('should use description from epic if available', async () => {
+            const epic = {
+                id: 'epic-51',
+                title: 'Epic with Description',
+                description: 'This is the epic description that should be used'
+            };
+            const result = await ensureEpicHasJiraKey({
+                epic,
+                _mockResponse: { key: 'MSSCI-11854' }
+            });
+            assert.strictEqual(result.success, true);
+            assert.ok(result.description?.includes('epic description'), 'Should use epic description');
+        });
+    });
+    describe('extractEpicNumberFromJiraKey() - Derive epic number', () => {
+        it('should extract number from Jira key', () => {
+            // AC4: Epic number derived from Jira ticket number
+            const epicNumber = extractEpicNumberFromJiraKey('MSSCI-11796');
+            assert.strictEqual(epicNumber, 11796);
+        });
+        it('should handle different project prefixes', () => {
+            const epicNumber = extractEpicNumberFromJiraKey('TEST-123');
+            assert.strictEqual(epicNumber, 123);
+        });
+        it('should return null for invalid format', () => {
+            const epicNumber = extractEpicNumberFromJiraKey('invalid-key');
+            assert.strictEqual(epicNumber, null);
+        });
+        it('should return null for empty input', () => {
+            const epicNumber = extractEpicNumberFromJiraKey('');
+            assert.strictEqual(epicNumber, null);
+        });
+        it('should return null for null input', () => {
+            const epicNumber = extractEpicNumberFromJiraKey(null);
+            assert.strictEqual(epicNumber, null);
+        });
+    });
+    describe('updateSprintYamlWithJiraKey() - Update YAML', () => {
+        it('should add jira field to epic in sprint YAML', async () => {
+            // AC3: Updates sprint YAML with new Jira key
+            const sprintYaml = `sprint:
+  number: 11
+epics:
+  - id: epic-47
+    title: Jira-Pennyfarthing Sync Improvements
+    points: 15
+    status: in_progress
+    stories:
+      - id: 47-1
+        title: Auto-create Jira epic
+        status: backlog
+`;
+            const sprintPath = join(TEST_DIR, 'current-sprint.yaml');
+            writeFileSync(sprintPath, sprintYaml);
+            const result = await updateSprintYamlWithJiraKey({
+                sprintPath,
+                epicId: 'epic-47',
+                jiraKey: 'MSSCI-11796'
+            });
+            assert.strictEqual(result.success, true, 'Update should succeed');
+            // Verify the file was updated
+            const updatedContent = readFileSync(sprintPath, 'utf-8');
+            assert.ok(updatedContent.includes('jira: MSSCI-11796'), 'YAML should contain new jira key');
+        });
+        it('should not modify other fields when adding jira key', async () => {
+            const sprintYaml = `sprint:
+  number: 11
+epics:
+  - id: epic-47
+    title: Test Epic Title
+    points: 15
+    priority: P1
+    status: in_progress
+`;
+            const sprintPath = join(TEST_DIR, 'current-sprint.yaml');
+            writeFileSync(sprintPath, sprintYaml);
+            await updateSprintYamlWithJiraKey({
+                sprintPath,
+                epicId: 'epic-47',
+                jiraKey: 'MSSCI-11800'
+            });
+            const updatedContent = readFileSync(sprintPath, 'utf-8');
+            assert.ok(updatedContent.includes('title: Test Epic Title'), 'Title should be preserved');
+            assert.ok(updatedContent.includes('points: 15'), 'Points should be preserved');
+            assert.ok(updatedContent.includes('priority: P1'), 'Priority should be preserved');
+        });
+        it('should handle epic id without "epic-" prefix', async () => {
+            // Epic IDs can be "47" or "epic-47"
+            const sprintYaml = `sprint:
+  number: 11
+epics:
+  - id: "47"
+    title: Numeric ID Epic
+    status: in_progress
+`;
+            const sprintPath = join(TEST_DIR, 'current-sprint.yaml');
+            writeFileSync(sprintPath, sprintYaml);
+            const result = await updateSprintYamlWithJiraKey({
+                sprintPath,
+                epicId: '47',
+                jiraKey: 'MSSCI-11801'
+            });
+            assert.strictEqual(result.success, true);
+            const updatedContent = readFileSync(sprintPath, 'utf-8');
+            assert.ok(updatedContent.includes('jira: MSSCI-11801'));
+        });
+        it('should fail gracefully if epic not found', async () => {
+            const sprintYaml = `sprint:
+  number: 11
+epics:
+  - id: epic-35
+    title: Different Epic
+`;
+            const sprintPath = join(TEST_DIR, 'current-sprint.yaml');
+            writeFileSync(sprintPath, sprintYaml);
+            const result = await updateSprintYamlWithJiraKey({
+                sprintPath,
+                epicId: 'epic-99', // Does not exist
+                jiraKey: 'MSSCI-11802'
+            });
+            assert.strictEqual(result.success, false);
+            assert.ok(result.error?.includes('not found'), 'Should mention epic not found');
+        });
+        it('should not overwrite existing jira key unless forced', async () => {
+            const sprintYaml = `sprint:
+  number: 11
+epics:
+  - id: epic-47
+    title: Epic with Existing Jira
+    jira: MSSCI-11700
+`;
+            const sprintPath = join(TEST_DIR, 'current-sprint.yaml');
+            writeFileSync(sprintPath, sprintYaml);
+            const result = await updateSprintYamlWithJiraKey({
+                sprintPath,
+                epicId: 'epic-47',
+                jiraKey: 'MSSCI-11803'
+            });
+            assert.strictEqual(result.success, false);
+            assert.ok(result.error?.includes('already has'), 'Should not overwrite existing key');
+            // Verify original key preserved
+            const updatedContent = readFileSync(sprintPath, 'utf-8');
+            assert.ok(updatedContent.includes('jira: MSSCI-11700'), 'Original key should be preserved');
+        });
+        it('should overwrite existing jira key when force option is true', async () => {
+            const sprintYaml = `sprint:
+  number: 11
+epics:
+  - id: epic-47
+    title: Epic with Existing Jira
+    jira: MSSCI-11700
+`;
+            const sprintPath = join(TEST_DIR, 'current-sprint.yaml');
+            writeFileSync(sprintPath, sprintYaml);
+            const result = await updateSprintYamlWithJiraKey({
+                sprintPath,
+                epicId: 'epic-47',
+                jiraKey: 'MSSCI-11804',
+                force: true
+            });
+            assert.strictEqual(result.success, true);
+            const updatedContent = readFileSync(sprintPath, 'utf-8');
+            assert.ok(updatedContent.includes('jira: MSSCI-11804'), 'Should have new key with force option');
+        });
+    });
+    describe('SM Setup Integration', () => {
+        it('should detect epic without jira during story setup', async () => {
+            // AC1: SM setup detects new epic without jira field
+            // This tests the integration point in generic-sm-setup
+            const sprintYaml = `sprint:
+  number: 11
+epics:
+  - id: epic-48
+    title: New Epic Without Jira
+    status: in_progress
+    stories:
+      - id: 48-1
+        title: First Story
+        status: backlog
+        points: 3
+`;
+            const sprintPath = join(TEST_DIR, 'current-sprint.yaml');
+            writeFileSync(sprintPath, sprintYaml);
+            // Import the SM setup check function (to be added)
+            // This would be called during MODE=setup before story setup
+            const { checkEpicJiraRequired } = await import('./jira-epic-creation.js');
+            const result = await checkEpicJiraRequired({
+                storyId: '48-1',
+                sprintPath
+            });
+            assert.strictEqual(result.epicNeedsJira, true, 'Should detect epic needs Jira key');
+            assert.strictEqual(result.epicId, 'epic-48');
+            assert.strictEqual(result.epicTitle, 'New Epic Without Jira');
+        });
+        it('should not flag epic that already has jira key', async () => {
+            const sprintYaml = `sprint:
+  number: 11
+epics:
+  - id: epic-35
+    title: Epic With Jira
+    jira: MSSCI-11715
+    stories:
+      - id: 35-1
+        title: Story in Epic With Jira
+        status: backlog
+`;
+            const sprintPath = join(TEST_DIR, 'current-sprint.yaml');
+            writeFileSync(sprintPath, sprintYaml);
+            const { checkEpicJiraRequired } = await import('./jira-epic-creation.js');
+            const result = await checkEpicJiraRequired({
+                storyId: '35-1',
+                sprintPath
+            });
+            assert.strictEqual(result.epicNeedsJira, false, 'Should not flag epic that has jira key');
+        });
+    });
+});
+//# sourceMappingURL=jira-epic-creation.test.js.map

package/dist/jira/jira-epic-creation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-epic-creation.test.js","sourceRoot":"","sources":["../../src/jira/jira-epic-creation.test.ts"],"names":[],"mappings":"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"}

package/dist/jira/jira-sprint-sync.d.ts

@@ -0,0 +1,247 @@
+/**
+ * Jira Sprint Sync Functions
+ *
+ * Story 47-2: Sync sprint numbers with Jira sprint IDs
+ *
+ * These functions enable bidirectional sprint tracking between
+ * Pennyfarthing's local sprint YAML and Jira's sprint system.
+ */
+export interface JiraSprintInfo {
+    id: number;
+    name: string;
+    state: 'active' | 'closed' | 'future';
+    startDate?: string;
+    endDate?: string;
+}
+export interface SprintIssue {
+    key: string;
+    summary: string;
+    status: string;
+    points?: number;
+    labels?: string[];
+}
+export interface SprintVelocityMetrics {
+    totalPoints: number;
+    completedPoints: number;
+    remainingPoints: number;
+    velocityPercentage?: number;
+    issueCount?: number;
+    completedCount?: number;
+    byStatus?: Record<string, {
+        count: number;
+        points: number;
+    }>;
+}
+export interface SprintSyncResult {
+    success: boolean;
+    error?: string;
+    warning?: string;
+}
+export interface AddJiraSprintIdOptions {
+    sprintPath: string;
+    jiraSprintId: number;
+    force?: boolean;
+}
+export interface AddJiraSprintIdResult extends SprintSyncResult {
+    previousId?: number;
+}
+/**
+ * Add or update jira_sprint_id field in sprint YAML
+ */
+export declare function addJiraSprintIdToYaml(options: AddJiraSprintIdOptions): Promise<AddJiraSprintIdResult>;
+export interface GetJiraSprintInfoOptions {
+    sprintId: number;
+    _mockResponse?: JiraSprintInfo | null;
+    _mockError?: string;
+}
+export interface GetJiraSprintInfoResult extends SprintSyncResult {
+    sprint?: JiraSprintInfo;
+}
+/**
+ * Get sprint details from Jira
+ */
+export declare function getJiraSprintInfo(options: GetJiraSprintInfoOptions): Promise<GetJiraSprintInfoResult>;
+export interface GetSprintIssuesOptions {
+    sprintId: number;
+    label?: string;
+    _mockResponse?: SprintIssue[];
+    _mockError?: string;
+}
+export interface GetSprintIssuesResult extends SprintSyncResult {
+    issues?: SprintIssue[];
+}
+/**
+ * Get all issues in a Jira sprint
+ */
+export declare function getSprintIssues(options: GetSprintIssuesOptions): Promise<GetSprintIssuesResult>;
+export interface IsStoryInJiraSprintOptions {
+    jiraKey: string;
+    sprintId: number;
+    _mockResponse?: boolean;
+    _mockError?: string;
+}
+export interface IsStoryInJiraSprintResult extends SprintSyncResult {
+    inSprint?: boolean;
+}
+/**
+ * Check if a specific story is in a Jira sprint
+ */
+export declare function isStoryInJiraSprint(options: IsStoryInJiraSprintOptions): Promise<IsStoryInJiraSprintResult>;
+export interface GetSprintVelocityOptions {
+    sprintId: number;
+    _mockResponse?: SprintVelocityMetrics;
+    _mockError?: string;
+}
+export interface GetSprintVelocityResult extends SprintSyncResult {
+    metrics?: SprintVelocityMetrics;
+}
+/**
+ * Get velocity metrics from Jira sprint
+ */
+export declare function getSprintVelocityFromJira(options: GetSprintVelocityOptions): Promise<GetSprintVelocityResult>;
+export interface ValidateSprintAlignmentOptions {
+    sprintPath: string;
+    _mockJiraSprint?: JiraSprintInfo | null;
+    _mockError?: string;
+}
+export interface ValidateSprintAlignmentResult extends SprintSyncResult {
+    aligned?: boolean;
+    localSprintName?: string;
+    jiraSprintId?: number;
+    jiraSprintName?: string;
+}
+/**
+ * Validate that local sprint name matches Jira sprint name
+ */
+export declare function validateSprintAlignment(options: ValidateSprintAlignmentOptions): Promise<ValidateSprintAlignmentResult>;
+export interface MissingStory extends SprintIssue {
+    storyId: string;
+}
+export interface GetYamlStoryIdsOptions {
+    sprintPath: string;
+}
+export interface GetYamlStoryIdsResult extends SprintSyncResult {
+    storyIds?: string[];
+}
+export interface FindJiraOnlyStoriesOptions {
+    jiraIssues: SprintIssue[];
+    yamlStoryIds: string[];
+    filterLabel?: string;
+}
+export interface FindJiraOnlyStoriesResult extends SprintSyncResult {
+    missingStories?: MissingStory[];
+}
+export interface FormatMissingStoriesReportOptions {
+    missingStories: MissingStory[];
+    jiraBaseUrl?: string;
+}
+export interface FormatMissingStoriesReportResult extends SprintSyncResult {
+    report?: string;
+}
+export interface ImportMissingStoriesToYamlOptions {
+    sprintPath: string;
+    missingStories: MissingStory[];
+    targetEpicId: string;
+    dryRun?: boolean;
+}
+export interface ImportMissingStoriesToYamlResult extends SprintSyncResult {
+    importedCount?: number;
+    wouldImport?: MissingStory[];
+}
+/**
+ * Extract all story IDs from sprint YAML file
+ */
+export declare function getYamlStoryIds(options: GetYamlStoryIdsOptions): Promise<GetYamlStoryIdsResult>;
+/**
+ * Find stories that are in Jira but not in the sprint YAML
+ */
+export declare function findJiraOnlyStories(options: FindJiraOnlyStoriesOptions): Promise<FindJiraOnlyStoriesResult>;
+/**
+ * Generate a human-readable report of missing stories
+ */
+export declare function formatMissingStoriesReport(options: FormatMissingStoriesReportOptions): Promise<FormatMissingStoriesReportResult>;
+/**
+ * Import missing stories from Jira into sprint YAML
+ */
+export declare function importMissingStoriesToYaml(options: ImportMissingStoriesToYamlOptions): Promise<ImportMissingStoriesToYamlResult>;
+export interface StorySprintMembership {
+    storyId: string;
+    jiraKey: string;
+    inSprint: boolean;
+    jiraSprintId?: number;
+}
+export interface SyncStorySprintMembershipOptions {
+    sprintPath: string;
+    jiraSprintId: number;
+    _mockJiraIssues?: SprintIssue[];
+    _mockError?: string;
+}
+export interface SyncStorySprintMembershipResult extends SprintSyncResult {
+    updated?: number;
+    added?: string[];
+    removed?: string[];
+    unchanged?: number;
+}
+/**
+ * Sync story sprint membership between YAML and Jira
+ *
+ * Direction: Jira → YAML
+ * - Stories in Jira sprint get in_sprint: true
+ * - Stories not in Jira sprint get in_sprint: false
+ */
+export declare function syncStorySprintMembershipFromJira(options: SyncStorySprintMembershipOptions): Promise<SyncStorySprintMembershipResult>;
+export interface AddStoryToJiraSprintOptions {
+    jiraKey: string;
+    sprintId: number;
+    _mockSuccess?: boolean;
+    _mockError?: string;
+}
+export interface AddStoryToJiraSprintResult extends SprintSyncResult {
+    added?: boolean;
+}
+/**
+ * Add a story to a Jira sprint
+ *
+ * Direction: YAML → Jira
+ * Uses: jira sprint add {sprintId} {jiraKey}
+ */
+export declare function addStoryToJiraSprint(options: AddStoryToJiraSprintOptions): Promise<AddStoryToJiraSprintResult>;
+export interface RemoveStoryFromJiraSprintOptions {
+    jiraKey: string;
+    _mockSuccess?: boolean;
+    _mockError?: string;
+}
+export interface RemoveStoryFromJiraSprintResult extends SprintSyncResult {
+    removed?: boolean;
+}
+/**
+ * Remove a story from its current Jira sprint (move to backlog)
+ *
+ * Direction: YAML → Jira
+ * Uses: jira issue edit {jiraKey} --sprint "" or move to backlog
+ */
+export declare function removeStoryFromJiraSprint(options: RemoveStoryFromJiraSprintOptions): Promise<RemoveStoryFromJiraSprintResult>;
+export interface SyncStorySprintMembershipToJiraOptions {
+    sprintPath: string;
+    jiraSprintId: number;
+    dryRun?: boolean;
+    _mockAddSuccess?: boolean;
+    _mockRemoveSuccess?: boolean;
+    _mockError?: string;
+}
+export interface SyncStorySprintMembershipToJiraResult extends SprintSyncResult {
+    toAdd?: string[];
+    toRemove?: string[];
+    added?: string[];
+    removed?: string[];
+    failed?: string[];
+}
+/**
+ * Sync story sprint membership from YAML to Jira
+ *
+ * Direction: YAML → Jira
+ * - Stories with in_sprint: true are added to Jira sprint
+ * - Stories with in_sprint: false are removed from Jira sprint
+ */
+export declare function syncStorySprintMembershipToJira(options: SyncStorySprintMembershipToJiraOptions): Promise<SyncStorySprintMembershipToJiraResult>;
+//# sourceMappingURL=jira-sprint-sync.d.ts.map

package/dist/jira/jira-sprint-sync.d.ts.map

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