ai-sdlc 0.3.1-alpha.0-alpha.9 → 0.3.1-alpha.2

package/dist/services/github-projects/client.d.ts

@@ -0,0 +1,25 @@
+/**
+ * GitHub Projects v2 API client using gh CLI.
+ */
+import { ProjectItem, GitHubProjectsConfig } from './types.js';
+/**
+ * Check if gh CLI is available.
+ */
+export declare function isGhAvailable(): boolean;
+/**
+ * Get all items from a GitHub Project.
+ *
+ * @param config - GitHub Projects configuration
+ * @returns Array of project items
+ * @throws Error if gh CLI is not available or API call fails
+ */
+export declare function getProjectItems(config: GitHubProjectsConfig): Promise<ProjectItem[]>;
+/**
+ * Get priority for a specific issue from a GitHub Project.
+ *
+ * @param config - GitHub Projects configuration
+ * @param issueNumber - Issue number to look up
+ * @returns Normalized priority value, or null if issue not in project
+ */
+export declare function getIssuePriorityFromProject(config: GitHubProjectsConfig, issueNumber: number): Promise<number | null>;
+//# sourceMappingURL=client.d.ts.map

package/dist/services/github-projects/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/services/github-projects/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAI/D;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAOvC;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAwD1F;AAED;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,oBAAoB,EAC5B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuBxB"}

package/dist/services/github-projects/client.js

@@ -0,0 +1,99 @@
+/**
+ * GitHub Projects v2 API client using gh CLI.
+ */
+import { execSync } from 'child_process';
+import { buildProjectItemsQuery, extractPriorityValue } from './queries.js';
+import { normalizePositionPriority, normalizeMappedPriority } from './priority-normalizer.js';
+/**
+ * Check if gh CLI is available.
+ */
+export function isGhAvailable() {
+    try {
+        execSync('gh --version', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get all items from a GitHub Project.
+ *
+ * @param config - GitHub Projects configuration
+ * @returns Array of project items
+ * @throws Error if gh CLI is not available or API call fails
+ */
+export async function getProjectItems(config) {
+    if (!isGhAvailable()) {
+        throw new Error('gh CLI is not available. Please install it: https://cli.github.com/');
+    }
+    const query = buildProjectItemsQuery(config.owner, config.projectNumber, config.priorityField);
+    try {
+        const result = execSync(`gh api graphql -f query='${query.replace(/'/g, "'\\''")}'`, {
+            encoding: 'utf-8',
+            maxBuffer: 10 * 1024 * 1024, // 10MB buffer for large projects
+        });
+        const data = JSON.parse(result);
+        // Try organization path first, then user path
+        const projectData = data.data?.org?.projectV2 || data.data?.user?.projectV2;
+        if (!projectData) {
+            throw new Error(`Project #${config.projectNumber} not found for owner "${config.owner}"`);
+        }
+        const items = [];
+        const nodes = projectData.items?.nodes || [];
+        for (let i = 0; i < nodes.length; i++) {
+            const node = nodes[i];
+            // Skip non-issue items (could be draft issues, pull requests, etc.)
+            if (!node.content?.number) {
+                continue;
+            }
+            const item = {
+                issueNumber: node.content.number,
+                position: i + 1, // 1-indexed position
+            };
+            // Extract priority field value if present
+            if (node.priorityValue) {
+                const priorityValue = extractPriorityValue(node.priorityValue);
+                if (priorityValue) {
+                    item.priorityValue = priorityValue;
+                }
+            }
+            items.push(item);
+        }
+        return items;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to fetch GitHub Project items: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Get priority for a specific issue from a GitHub Project.
+ *
+ * @param config - GitHub Projects configuration
+ * @param issueNumber - Issue number to look up
+ * @returns Normalized priority value, or null if issue not in project
+ */
+export async function getIssuePriorityFromProject(config, issueNumber) {
+    const items = await getProjectItems(config);
+    const item = items.find((i) => i.issueNumber === issueNumber);
+    if (!item) {
+        return null; // Issue not in project
+    }
+    // If priorityField is configured and item has a value, use mapping
+    if (config.priorityField && item.priorityValue && config.priorityMapping) {
+        const mappedPriority = normalizeMappedPriority(item.priorityValue, config.priorityMapping);
+        if (mappedPriority !== null) {
+            return mappedPriority;
+        }
+        // Fall through to position-based if mapping doesn't contain the value
+    }
+    // Use position-based priority as fallback
+    if (item.position) {
+        return normalizePositionPriority(item.position);
+    }
+    return null;
+}
+//# sourceMappingURL=client.js.map

package/dist/services/github-projects/client.js.map

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

package/dist/services/github-projects/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * GitHub Projects v2 integration for priority sync.
+ */
+export * from './types.js';
+export * from './client.js';
+export * from './priority-normalizer.js';
+export * from './queries.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/github-projects/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/github-projects/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC"}

package/dist/services/github-projects/index.js

@@ -0,0 +1,8 @@
+/**
+ * GitHub Projects v2 integration for priority sync.
+ */
+export * from './types.js';
+export * from './client.js';
+export * from './priority-normalizer.js';
+export * from './queries.js';
+//# sourceMappingURL=index.js.map

package/dist/services/github-projects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/github-projects/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC"}

package/dist/services/github-projects/priority-normalizer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Utilities for normalizing priority values from GitHub Projects.
+ */
+/**
+ * Normalize position-based priority.
+ * Converts project position (1, 2, 3, ...) to priority value (10, 20, 30, ...).
+ *
+ * @param position - Position in the project (1-indexed)
+ * @returns Normalized priority value (position * 10)
+ */
+export declare function normalizePositionPriority(position: number): number;
+/**
+ * Normalize priority using a field value mapping.
+ * Maps priority field values (e.g., 'P0', 'P1', 'High') to numeric priorities.
+ *
+ * @param value - Priority field value from GitHub Projects
+ * @param mapping - Mapping from field values to numeric priorities
+ * @returns Normalized priority value, or null if value not in mapping
+ */
+export declare function normalizeMappedPriority(value: string, mapping: Record<string, number>): number | null;
+//# sourceMappingURL=priority-normalizer.d.ts.map

package/dist/services/github-projects/priority-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-normalizer.d.ts","sourceRoot":"","sources":["../../../src/services/github-projects/priority-normalizer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,GAAG,IAAI,CAYf"}

package/dist/services/github-projects/priority-normalizer.js

@@ -0,0 +1,36 @@
+/**
+ * Utilities for normalizing priority values from GitHub Projects.
+ */
+/**
+ * Normalize position-based priority.
+ * Converts project position (1, 2, 3, ...) to priority value (10, 20, 30, ...).
+ *
+ * @param position - Position in the project (1-indexed)
+ * @returns Normalized priority value (position * 10)
+ */
+export function normalizePositionPriority(position) {
+    if (position <= 0) {
+        throw new Error(`Invalid position: ${position} (must be positive)`);
+    }
+    return position * 10;
+}
+/**
+ * Normalize priority using a field value mapping.
+ * Maps priority field values (e.g., 'P0', 'P1', 'High') to numeric priorities.
+ *
+ * @param value - Priority field value from GitHub Projects
+ * @param mapping - Mapping from field values to numeric priorities
+ * @returns Normalized priority value, or null if value not in mapping
+ */
+export function normalizeMappedPriority(value, mapping) {
+    const priority = mapping[value];
+    if (priority === undefined) {
+        return null;
+    }
+    // Validate that the mapped value is a valid number
+    if (typeof priority !== 'number' || !Number.isFinite(priority) || priority <= 0) {
+        throw new Error(`Invalid priority mapping for "${value}": ${priority} (must be positive finite number)`);
+    }
+    return priority;
+}
+//# sourceMappingURL=priority-normalizer.js.map

package/dist/services/github-projects/priority-normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-normalizer.js","sourceRoot":"","sources":["../../../src/services/github-projects/priority-normalizer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,qBAAqB,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,QAAQ,GAAG,EAAE,CAAC;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAa,EACb,OAA+B;IAE/B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mDAAmD;IACnD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,MAAM,QAAQ,mCAAmC,CAAC,CAAC;IAC3G,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/services/github-projects/queries.d.ts

@@ -0,0 +1,17 @@
+/**
+ * GraphQL queries for GitHub Projects v2 API.
+ */
+/**
+ * Query to fetch all items from a GitHub Project with priority field.
+ * This query is designed to work with both organization and user projects.
+ *
+ * @param owner - The owner login (organization or user)
+ * @param number - The project number
+ * @param priorityField - Optional name of the priority field to fetch
+ */
+export declare function buildProjectItemsQuery(owner: string, number: number, priorityField?: string): string;
+/**
+ * Extract priority value from a GraphQL field value node.
+ */
+export declare function extractPriorityValue(fieldValue: any): string | undefined;
+//# sourceMappingURL=queries.d.ts.map

package/dist/services/github-projects/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/services/github-projects/queries.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CA+CpG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAmBxE"}

package/dist/services/github-projects/queries.js

@@ -0,0 +1,79 @@
+/**
+ * GraphQL queries for GitHub Projects v2 API.
+ */
+/**
+ * Query to fetch all items from a GitHub Project with priority field.
+ * This query is designed to work with both organization and user projects.
+ *
+ * @param owner - The owner login (organization or user)
+ * @param number - The project number
+ * @param priorityField - Optional name of the priority field to fetch
+ */
+export function buildProjectItemsQuery(owner, number, priorityField) {
+    const priorityFieldFragment = priorityField
+        ? `
+            priorityValue: fieldValueByName(name: "${priorityField}") {
+              ... on ProjectV2ItemFieldSingleSelectValue {
+                name
+              }
+              ... on ProjectV2ItemFieldTextValue {
+                text
+              }
+              ... on ProjectV2ItemFieldNumberValue {
+                number
+              }
+            }`
+        : '';
+    // Try both organization and user paths
+    return `
+    query {
+      org: organization(login: "${owner}") {
+        projectV2(number: ${number}) {
+          items(first: 100) {
+            nodes {
+              content {
+                ... on Issue {
+                  number
+                }
+              }${priorityFieldFragment}
+            }
+          }
+        }
+      }
+      user(login: "${owner}") {
+        projectV2(number: ${number}) {
+          items(first: 100) {
+            nodes {
+              content {
+                ... on Issue {
+                  number
+                }
+              }${priorityFieldFragment}
+            }
+          }
+        }
+      }
+    }
+  `;
+}
+/**
+ * Extract priority value from a GraphQL field value node.
+ */
+export function extractPriorityValue(fieldValue) {
+    if (!fieldValue)
+        return undefined;
+    // Single select field
+    if (fieldValue.name !== undefined) {
+        return fieldValue.name;
+    }
+    // Text field
+    if (fieldValue.text !== undefined) {
+        return fieldValue.text;
+    }
+    // Number field
+    if (fieldValue.number !== undefined) {
+        return String(fieldValue.number);
+    }
+    return undefined;
+}
+//# sourceMappingURL=queries.js.map

package/dist/services/github-projects/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/services/github-projects/queries.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa,EAAE,MAAc,EAAE,aAAsB;IAC1F,MAAM,qBAAqB,GAAG,aAAa;QACzC,CAAC,CAAC;qDAC+C,aAAa;;;;;;;;;;cAUpD;QACV,CAAC,CAAC,EAAE,CAAC;IAEP,uCAAuC;IACvC,OAAO;;kCAEyB,KAAK;4BACX,MAAM;;;;;;;iBAOjB,qBAAqB;;;;;qBAKjB,KAAK;4BACE,MAAM;;;;;;;iBAOjB,qBAAqB;;;;;;GAMnC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAe;IAClD,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAElC,sBAAsB;IACtB,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,UAAU,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,aAAa;IACb,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,UAAU,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,eAAe;IACf,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/services/github-projects/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Types for GitHub Projects v2 integration.
+ */
+/**
+ * Represents an item in a GitHub Project.
+ */
+export interface ProjectItem {
+    /** Issue number */
+    issueNumber: number;
+    /** Priority field value (e.g., 'P0', 'P1', 'High', 'Medium') */
+    priorityValue?: string;
+    /** Position in the project view (1-indexed) */
+    position?: number;
+}
+/**
+ * Priority data extracted from a GitHub Project.
+ */
+export interface ProjectPriorityData {
+    /** Normalized priority value (10, 20, 30, etc.) */
+    priority: number;
+    /** Source of the priority value */
+    source: PrioritySource;
+}
+/**
+ * Source of the priority value.
+ * - 'project-position': Priority derived from issue position in project board
+ * - 'project-field': Priority derived from explicit priority field value
+ * - 'local': Priority set locally, not synced from project
+ */
+export type PrioritySource = 'project-position' | 'project-field' | 'local';
+/**
+ * Configuration for GitHub Projects priority sync.
+ */
+export interface GitHubProjectsConfig {
+    /** Owner of the repository (org or user) */
+    owner: string;
+    /** Repository name */
+    repo: string;
+    /** GitHub Projects v2 project number */
+    projectNumber: number;
+    /** Name of the priority field in the project (if using explicit field) */
+    priorityField?: string;
+    /** Mapping from priority field values to numeric priorities */
+    priorityMapping?: Record<string, number>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/github-projects/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/github-projects/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,eAAe,GAAG,OAAO,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C"}

package/dist/services/github-projects/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for GitHub Projects v2 integration.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/github-projects/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/github-projects/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/services/priority-sync.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Service for syncing story priority from external ticketing systems.
+ */
+import { Story } from '../types/index.js';
+import { TicketProvider } from './ticket-provider/types.js';
+/**
+ * Sync priority for a single story from its ticket provider.
+ * Updates the story's priority and priority_source fields if a priority is returned.
+ *
+ * @param story - Story to sync priority for
+ * @param provider - Ticket provider to use for syncing
+ * @returns Updated story if priority was synced, null if no sync needed
+ */
+export declare function syncStoryPriority(story: Story, provider: TicketProvider): Promise<Story | null>;
+/**
+ * Sync priority for multiple stories.
+ * Continues on individual failures to ensure all stories are attempted.
+ *
+ * @param stories - Stories to sync priority for
+ * @param provider - Ticket provider to use for syncing
+ * @param onProgress - Optional callback for progress updates
+ * @returns Number of successfully synced stories
+ */
+export declare function syncAllStoriesPriority(stories: Story[], provider: TicketProvider, onProgress?: (current: number, total: number, story: Story) => void): Promise<number>;
+//# sourceMappingURL=priority-sync.d.ts.map

package/dist/services/priority-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-sync.d.ts","sourceRoot":"","sources":["../../src/services/priority-sync.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAoCvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,KAAK,EAAE,EAChB,QAAQ,EAAE,cAAc,EACxB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAClE,OAAO,CAAC,MAAM,CAAC,CAiBjB"}

package/dist/services/priority-sync.js

@@ -0,0 +1,67 @@
+/**
+ * Service for syncing story priority from external ticketing systems.
+ */
+import { updateStoryField } from '../core/story.js';
+/**
+ * Sync priority for a single story from its ticket provider.
+ * Updates the story's priority and priority_source fields if a priority is returned.
+ *
+ * @param story - Story to sync priority for
+ * @param provider - Ticket provider to use for syncing
+ * @returns Updated story if priority was synced, null if no sync needed
+ */
+export async function syncStoryPriority(story, provider) {
+    // Only sync if story has a ticket ID and provider supports priority sync
+    if (!story.frontmatter.ticket_id || !provider.syncPriority) {
+        return null;
+    }
+    try {
+        const priority = await provider.syncPriority(story.frontmatter.ticket_id);
+        // If priority is null, the ticket is not in a project - keep local priority
+        if (priority === null) {
+            return null;
+        }
+        // Update priority if it changed
+        if (story.frontmatter.priority !== priority) {
+            await updateStoryField(story, 'priority', priority);
+            await updateStoryField(story, 'priority_source', 'github-project');
+            await updateStoryField(story, 'ticket_synced_at', new Date().toISOString());
+            return story;
+        }
+        // Priority unchanged, but update sync timestamp
+        if (story.frontmatter.priority_source !== 'github-project') {
+            await updateStoryField(story, 'priority_source', 'github-project');
+        }
+        await updateStoryField(story, 'ticket_synced_at', new Date().toISOString());
+        return story;
+    }
+    catch (error) {
+        // Log error but don't throw - gracefully continue with local priority
+        console.warn(`Failed to sync priority for story ${story.slug}: ${error instanceof Error ? error.message : String(error)}`);
+        return null;
+    }
+}
+/**
+ * Sync priority for multiple stories.
+ * Continues on individual failures to ensure all stories are attempted.
+ *
+ * @param stories - Stories to sync priority for
+ * @param provider - Ticket provider to use for syncing
+ * @param onProgress - Optional callback for progress updates
+ * @returns Number of successfully synced stories
+ */
+export async function syncAllStoriesPriority(stories, provider, onProgress) {
+    let syncedCount = 0;
+    for (let i = 0; i < stories.length; i++) {
+        const story = stories[i];
+        if (onProgress) {
+            onProgress(i + 1, stories.length, story);
+        }
+        const updated = await syncStoryPriority(story, provider);
+        if (updated) {
+            syncedCount++;
+        }
+    }
+    return syncedCount;
+}
+//# sourceMappingURL=priority-sync.js.map

package/dist/services/priority-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-sync.js","sourceRoot":"","sources":["../../src/services/priority-sync.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAY,EACZ,QAAwB;IAExB,yEAAyE;IACzE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAE1E,4EAA4E;QAC5E,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,gCAAgC;QAChC,IAAI,KAAK,CAAC,WAAW,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC5C,MAAM,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;YACpD,MAAM,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;YACnE,MAAM,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;YAC5E,OAAO,KAAK,CAAC;QACf,CAAC;QAED,gDAAgD;QAChD,IAAI,KAAK,CAAC,WAAW,CAAC,eAAe,KAAK,gBAAgB,EAAE,CAAC;YAC3D,MAAM,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAE5E,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sEAAsE;QACtE,OAAO,CAAC,IAAI,CACV,qCAAqC,KAAK,CAAC,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC7G,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAgB,EAChB,QAAwB,EACxB,UAAmE;IAEnE,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAEzB,IAAI,UAAU,EAAE,CAAC;YACf,UAAU,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACzD,IAAI,OAAO,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-sdlc",
-  "version": "0.3.1-alpha.0-alpha.9",
+  "version": "0.3.1-alpha.2",
   "description": "Agent-first SDLC workflow manager using Claude Agent SDK",
   "type": "module",
   "main": "dist/index.js",