@bretwardjames/ghp-core 0.9.0 → 0.11.0

package/dist/index.cjs

@@ -337,6 +337,10 @@ var PROJECT_FIELDS_QUERY = `
                         ... on ProjectV2IterationField {
                             id
                             name
+                            configuration {
+                                iterations { id title }
+                                completedIterations { id title }
+                            }
                         }
                     }
                 }
@@ -1276,6 +1280,21 @@ var GitHubAPI = class {
       return false;
     }
   }
+  /**
+   * Move an issue to a target status in its project.
+   * Returns { success, error? } — does not throw.
+   */
+  async moveIssueToStatus(repo, issueNumber, targetStatus) {
+    const item = await this.findItemByNumber(repo, issueNumber);
+    if (!item) return { success: false, error: `Issue #${issueNumber} not found in any project` };
+    if (item.status === targetStatus) return { success: true };
+    const statusField = await this.getStatusField(item.projectId);
+    if (!statusField) return { success: false, error: "Could not find Status field on project" };
+    const option = statusField.options.find((o) => o.name === targetStatus);
+    if (!option) return { success: false, error: `Status "${targetStatus}" not found. Available: ${statusField.options.map((o) => o.name).join(", ")}` };
+    const updated = await this.updateItemStatus(item.projectId, item.id, statusField.fieldId, option.id);
+    return updated ? { success: true } : { success: false, error: "Failed to update status" };
+  }
   /**
    * Find an item by issue number - direct lookup via issue's projectItems
    * Much faster than iterating through all project items
@@ -1350,28 +1369,48 @@ var GitHubAPI = class {
   async getProjectFields(projectId) {
     if (!this.graphqlWithAuth) throw new Error("Not authenticated");
     const response = await this.graphqlWithRetry(PROJECT_FIELDS_QUERY, { projectId });
-    return response.node.fields.nodes.map((f) => ({
-      id: f.id,
-      name: f.name,
-      type: f.__typename.replace("ProjectV2", "").replace("Field", ""),
-      options: f.options
-    }));
+    return response.node.fields.nodes.map((f) => {
+      let options = f.options;
+      if (f.configuration) {
+        const all = [...f.configuration.iterations, ...f.configuration.completedIterations];
+        options = all.map((i) => ({ id: i.id, name: i.title }));
+      }
+      return {
+        id: f.id,
+        name: f.name,
+        type: f.__typename.replace("ProjectV2", "").replace("Field", ""),
+        options
+      };
+    });
   }
   /**
-   * Set a field value on a project item
+   * Set a field value on a project item.
+   * Routes SingleSelect fields through the inline mutation pattern
+   * (passing the option ID as a scalar variable) since GitHub's API
+   * does not reliably deserialize ProjectV2FieldValue input objects.
    */
   async setFieldValue(projectId, itemId, fieldId, value) {
     if (!this.graphqlWithAuth) throw new Error("Not authenticated");
     try {
-      await this.graphqlWithRetry(UPDATE_ITEM_FIELD_MUTATION, {
-        projectId,
-        itemId,
-        fieldId,
-        value
-      });
-      return true;
-    } catch {
-      return false;
+      if (value.singleSelectOptionId) {
+        await this.graphqlWithRetry(UPDATE_ITEM_STATUS_MUTATION, {
+          projectId,
+          itemId,
+          fieldId,
+          optionId: value.singleSelectOptionId
+        });
+      } else {
+        await this.graphqlWithRetry(UPDATE_ITEM_FIELD_MUTATION, {
+          projectId,
+          itemId,
+          fieldId,
+          value
+        });
+      }
+      return { success: true };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return { success: false, error: message };
     }
   }
   /**
@@ -2627,31 +2666,41 @@ var SYNCABLE_KEYS = [
   "mainBranch",
   "branchPattern",
   "startWorkingStatus",
-  "doneStatus"
+  "doneStatus",
+  "prOpenedStatus",
+  "prMergedStatus"
 ];
 var SETTING_DISPLAY_NAMES = {
   mainBranch: "Main Branch",
   branchPattern: "Branch Name Pattern",
   startWorkingStatus: "Start Working Status",
-  doneStatus: "Done/PR Merged Status"
+  doneStatus: "Done Status",
+  prOpenedStatus: "PR Opened Status",
+  prMergedStatus: "PR Merged Status"
 };
 var VSCODE_TO_CLI_MAP = {
   "mainBranch": "mainBranch",
   "branchNamePattern": "branchPattern",
   "startWorkingStatus": "startWorkingStatus",
-  "prMergedStatus": "doneStatus"
+  "doneStatus": "doneStatus",
+  "prOpenedStatus": "prOpenedStatus",
+  "prMergedStatus": "prMergedStatus"
 };
 var CLI_TO_VSCODE_MAP = {
   mainBranch: "mainBranch",
   branchPattern: "branchNamePattern",
   startWorkingStatus: "startWorkingStatus",
-  doneStatus: "prMergedStatus"
+  doneStatus: "doneStatus",
+  prOpenedStatus: "prOpenedStatus",
+  prMergedStatus: "prMergedStatus"
 };
 var DEFAULT_VALUES = {
   mainBranch: "main",
   branchPattern: "{user}/{number}-{title}",
   startWorkingStatus: "In Progress",
-  doneStatus: "Done"
+  doneStatus: "Done",
+  prOpenedStatus: "In Review",
+  prMergedStatus: "Ready for Beta"
 };
 function normalizeVSCodeSettings(vscodeSettings) {
   const result = {};

package/dist/index.d.cts

@@ -539,6 +539,14 @@ declare class GitHubAPI {
      * Update an item's status
      */
     updateItemStatus(projectId: string, itemId: string, fieldId: string, optionId: string): Promise<boolean>;
+    /**
+     * Move an issue to a target status in its project.
+     * Returns { success, error? } — does not throw.
+     */
+    moveIssueToStatus(repo: RepoInfo, issueNumber: number, targetStatus: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
     /**
      * Find an item by issue number - direct lookup via issue's projectItems
      * Much faster than iterating through all project items
@@ -557,13 +565,21 @@ declare class GitHubAPI {
         }>;
     }>>;
     /**
-     * Set a field value on a project item
+     * Set a field value on a project item.
+     * Routes SingleSelect fields through the inline mutation pattern
+     * (passing the option ID as a scalar variable) since GitHub's API
+     * does not reliably deserialize ProjectV2FieldValue input objects.
      */
     setFieldValue(projectId: string, itemId: string, fieldId: string, value: {
         text?: string;
         number?: number;
         singleSelectOptionId?: string;
-    }): Promise<boolean>;
+        date?: string;
+        iterationId?: string;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
     /**
      * Create a new issue
      */
@@ -1013,7 +1029,7 @@ declare function buildOrgProjectUrl(org: string, projectNumber: number): string;
  * The canonical setting keys used in sync operations.
  * These are the CLI key names (used as the canonical form).
  */
-type SyncableSettingKey = 'mainBranch' | 'branchPattern' | 'startWorkingStatus' | 'doneStatus';
+type SyncableSettingKey = 'mainBranch' | 'branchPattern' | 'startWorkingStatus' | 'doneStatus' | 'prOpenedStatus' | 'prMergedStatus';
 /**
  * Settings that can be synced between CLI and VSCode.
  * Uses CLI key names as the canonical form.
@@ -1023,6 +1039,8 @@ interface SyncableSettings {
     branchPattern?: string;
     startWorkingStatus?: string;
     doneStatus?: string;
+    prOpenedStatus?: string;
+    prMergedStatus?: string;
 }
 /**
  * A source of settings (CLI or VSCode)
@@ -1179,7 +1197,7 @@ declare const PROJECT_ITEMS_QUERY = "\n    query($projectId: ID!, $cursor: Strin
 /**
  * Query to get project fields (including status options)
  */
-declare const PROJECT_FIELDS_QUERY = "\n    query($projectId: ID!) {\n        node(id: $projectId) {\n            ... on ProjectV2 {\n                fields(first: 30) {\n                    nodes {\n                        __typename\n                        ... on ProjectV2Field {\n                            id\n                            name\n                        }\n                        ... on ProjectV2SingleSelectField {\n                            id\n                            name\n                            options { id name }\n                        }\n                        ... on ProjectV2IterationField {\n                            id\n                            name\n                        }\n                    }\n                }\n            }\n        }\n    }\n";
+declare const PROJECT_FIELDS_QUERY = "\n    query($projectId: ID!) {\n        node(id: $projectId) {\n            ... on ProjectV2 {\n                fields(first: 30) {\n                    nodes {\n                        __typename\n                        ... on ProjectV2Field {\n                            id\n                            name\n                        }\n                        ... on ProjectV2SingleSelectField {\n                            id\n                            name\n                            options { id name }\n                        }\n                        ... on ProjectV2IterationField {\n                            id\n                            name\n                            configuration {\n                                iterations { id title }\n                                completedIterations { id title }\n                            }\n                        }\n                    }\n                }\n            }\n        }\n    }\n";
 /**
  * Query to get project views
  */

package/dist/index.d.ts

@@ -539,6 +539,14 @@ declare class GitHubAPI {
      * Update an item's status
      */
     updateItemStatus(projectId: string, itemId: string, fieldId: string, optionId: string): Promise<boolean>;
+    /**
+     * Move an issue to a target status in its project.
+     * Returns { success, error? } — does not throw.
+     */
+    moveIssueToStatus(repo: RepoInfo, issueNumber: number, targetStatus: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
     /**
      * Find an item by issue number - direct lookup via issue's projectItems
      * Much faster than iterating through all project items
@@ -557,13 +565,21 @@ declare class GitHubAPI {
         }>;
     }>>;
     /**
-     * Set a field value on a project item
+     * Set a field value on a project item.
+     * Routes SingleSelect fields through the inline mutation pattern
+     * (passing the option ID as a scalar variable) since GitHub's API
+     * does not reliably deserialize ProjectV2FieldValue input objects.
      */
     setFieldValue(projectId: string, itemId: string, fieldId: string, value: {
         text?: string;
         number?: number;
         singleSelectOptionId?: string;
-    }): Promise<boolean>;
+        date?: string;
+        iterationId?: string;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
     /**
      * Create a new issue
      */
@@ -1013,7 +1029,7 @@ declare function buildOrgProjectUrl(org: string, projectNumber: number): string;
  * The canonical setting keys used in sync operations.
  * These are the CLI key names (used as the canonical form).
  */
-type SyncableSettingKey = 'mainBranch' | 'branchPattern' | 'startWorkingStatus' | 'doneStatus';
+type SyncableSettingKey = 'mainBranch' | 'branchPattern' | 'startWorkingStatus' | 'doneStatus' | 'prOpenedStatus' | 'prMergedStatus';
 /**
  * Settings that can be synced between CLI and VSCode.
  * Uses CLI key names as the canonical form.
@@ -1023,6 +1039,8 @@ interface SyncableSettings {
     branchPattern?: string;
     startWorkingStatus?: string;
     doneStatus?: string;
+    prOpenedStatus?: string;
+    prMergedStatus?: string;
 }
 /**
  * A source of settings (CLI or VSCode)
@@ -1179,7 +1197,7 @@ declare const PROJECT_ITEMS_QUERY = "\n    query($projectId: ID!, $cursor: Strin
 /**
  * Query to get project fields (including status options)
  */
-declare const PROJECT_FIELDS_QUERY = "\n    query($projectId: ID!) {\n        node(id: $projectId) {\n            ... on ProjectV2 {\n                fields(first: 30) {\n                    nodes {\n                        __typename\n                        ... on ProjectV2Field {\n                            id\n                            name\n                        }\n                        ... on ProjectV2SingleSelectField {\n                            id\n                            name\n                            options { id name }\n                        }\n                        ... on ProjectV2IterationField {\n                            id\n                            name\n                        }\n                    }\n                }\n            }\n        }\n    }\n";
+declare const PROJECT_FIELDS_QUERY = "\n    query($projectId: ID!) {\n        node(id: $projectId) {\n            ... on ProjectV2 {\n                fields(first: 30) {\n                    nodes {\n                        __typename\n                        ... on ProjectV2Field {\n                            id\n                            name\n                        }\n                        ... on ProjectV2SingleSelectField {\n                            id\n                            name\n                            options { id name }\n                        }\n                        ... on ProjectV2IterationField {\n                            id\n                            name\n                            configuration {\n                                iterations { id title }\n                                completedIterations { id title }\n                            }\n                        }\n                    }\n                }\n            }\n        }\n    }\n";
 /**
  * Query to get project views
  */

package/dist/index.js

@@ -166,6 +166,10 @@ var PROJECT_FIELDS_QUERY = `
                         ... on ProjectV2IterationField {
                             id
                             name
+                            configuration {
+                                iterations { id title }
+                                completedIterations { id title }
+                            }
                         }
                     }
                 }
@@ -1105,6 +1109,21 @@ var GitHubAPI = class {
       return false;
     }
   }
+  /**
+   * Move an issue to a target status in its project.
+   * Returns { success, error? } — does not throw.
+   */
+  async moveIssueToStatus(repo, issueNumber, targetStatus) {
+    const item = await this.findItemByNumber(repo, issueNumber);
+    if (!item) return { success: false, error: `Issue #${issueNumber} not found in any project` };
+    if (item.status === targetStatus) return { success: true };
+    const statusField = await this.getStatusField(item.projectId);
+    if (!statusField) return { success: false, error: "Could not find Status field on project" };
+    const option = statusField.options.find((o) => o.name === targetStatus);
+    if (!option) return { success: false, error: `Status "${targetStatus}" not found. Available: ${statusField.options.map((o) => o.name).join(", ")}` };
+    const updated = await this.updateItemStatus(item.projectId, item.id, statusField.fieldId, option.id);
+    return updated ? { success: true } : { success: false, error: "Failed to update status" };
+  }
   /**
    * Find an item by issue number - direct lookup via issue's projectItems
    * Much faster than iterating through all project items
@@ -1179,28 +1198,48 @@ var GitHubAPI = class {
   async getProjectFields(projectId) {
     if (!this.graphqlWithAuth) throw new Error("Not authenticated");
     const response = await this.graphqlWithRetry(PROJECT_FIELDS_QUERY, { projectId });
-    return response.node.fields.nodes.map((f) => ({
-      id: f.id,
-      name: f.name,
-      type: f.__typename.replace("ProjectV2", "").replace("Field", ""),
-      options: f.options
-    }));
+    return response.node.fields.nodes.map((f) => {
+      let options = f.options;
+      if (f.configuration) {
+        const all = [...f.configuration.iterations, ...f.configuration.completedIterations];
+        options = all.map((i) => ({ id: i.id, name: i.title }));
+      }
+      return {
+        id: f.id,
+        name: f.name,
+        type: f.__typename.replace("ProjectV2", "").replace("Field", ""),
+        options
+      };
+    });
   }
   /**
-   * Set a field value on a project item
+   * Set a field value on a project item.
+   * Routes SingleSelect fields through the inline mutation pattern
+   * (passing the option ID as a scalar variable) since GitHub's API
+   * does not reliably deserialize ProjectV2FieldValue input objects.
    */
   async setFieldValue(projectId, itemId, fieldId, value) {
     if (!this.graphqlWithAuth) throw new Error("Not authenticated");
     try {
-      await this.graphqlWithRetry(UPDATE_ITEM_FIELD_MUTATION, {
-        projectId,
-        itemId,
-        fieldId,
-        value
-      });
-      return true;
-    } catch {
-      return false;
+      if (value.singleSelectOptionId) {
+        await this.graphqlWithRetry(UPDATE_ITEM_STATUS_MUTATION, {
+          projectId,
+          itemId,
+          fieldId,
+          optionId: value.singleSelectOptionId
+        });
+      } else {
+        await this.graphqlWithRetry(UPDATE_ITEM_FIELD_MUTATION, {
+          projectId,
+          itemId,
+          fieldId,
+          value
+        });
+      }
+      return { success: true };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return { success: false, error: message };
     }
   }
   /**
@@ -2456,31 +2495,41 @@ var SYNCABLE_KEYS = [
   "mainBranch",
   "branchPattern",
   "startWorkingStatus",
-  "doneStatus"
+  "doneStatus",
+  "prOpenedStatus",
+  "prMergedStatus"
 ];
 var SETTING_DISPLAY_NAMES = {
   mainBranch: "Main Branch",
   branchPattern: "Branch Name Pattern",
   startWorkingStatus: "Start Working Status",
-  doneStatus: "Done/PR Merged Status"
+  doneStatus: "Done Status",
+  prOpenedStatus: "PR Opened Status",
+  prMergedStatus: "PR Merged Status"
 };
 var VSCODE_TO_CLI_MAP = {
   "mainBranch": "mainBranch",
   "branchNamePattern": "branchPattern",
   "startWorkingStatus": "startWorkingStatus",
-  "prMergedStatus": "doneStatus"
+  "doneStatus": "doneStatus",
+  "prOpenedStatus": "prOpenedStatus",
+  "prMergedStatus": "prMergedStatus"
 };
 var CLI_TO_VSCODE_MAP = {
   mainBranch: "mainBranch",
   branchPattern: "branchNamePattern",
   startWorkingStatus: "startWorkingStatus",
-  doneStatus: "prMergedStatus"
+  doneStatus: "doneStatus",
+  prOpenedStatus: "prOpenedStatus",
+  prMergedStatus: "prMergedStatus"
 };
 var DEFAULT_VALUES = {
   mainBranch: "main",
   branchPattern: "{user}/{number}-{title}",
   startWorkingStatus: "In Progress",
-  doneStatus: "Done"
+  doneStatus: "Done",
+  prOpenedStatus: "In Review",
+  prMergedStatus: "Ready for Beta"
 };
 function normalizeVSCodeSettings(vscodeSettings) {
   const result = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bretwardjames/ghp-core",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Shared core library for GitHub Projects tools",
   "main": "dist/index.cjs",
   "module": "dist/index.js",