Struct ProjectSync 

pub struct ProjectSync { /* private fields */ }

Keeps a GitHub Projects V2 board in sync with orch task statuses.

Config keys (in ~/.orch/config.yml):

gh:
  project_id: "PVT_kwHO..."
  project_status_field_id: "PVTSSF_..."
  project_status_map:
    backlog: "option-id-1"
    in_progress: "option-id-2"
    review: "option-id-3"
    done: "option-id-4"

Implementations

impl ProjectSync

pub fn from_config() -> Option<Self>

Load from config. Returns None if project integration is not configured.

pub async fn discover_fields(project_id: &str) -> Result<Self>

Discover the Status field ID and option IDs from a project.

Queries the project’s fields via GraphQL and finds the single-select “Status” field, returning a ProjectSync populated with field/option IDs. Also discovers the “Estimate” number field if present.

pub async fn list_projects() -> Result<Vec<ProjectInfo>>

List all accessible projects for the authenticated user and their orgs.

pub async fn add_item(&self, issue_node_id: &str) -> Result<String>

Add an issue to the project board. Returns the project item ID.

pub async fn update_item_status( &self, item_id: &str, status: &Status, ) -> Result<()>

Update an item’s status column on the project board.

pub async fn sync_item_status( &self, issue_node_id: &str, status: &Status, ) -> Result<()>

Sync an issue’s project board status: add to project if needed, then update column.

This is the main entry point called from update_status().

pub fn status_to_column(status: &Status) -> &'static str

Map orch Status to a project board column key.

pub fn status_field_id(&self) -> &str

Get the status field ID.

pub fn status_map(&self) -> &HashMap<String, String>

Get the status map (column key → option ID).

pub fn estimate_field_id(&self) -> Option<&str>

Get the estimate field ID, if configured.

pub fn project_id(&self) -> &str

Get the project ID.

pub async fn sync_item_estimate( &self, issue_node_id: &str, estimate: u8, ) -> Result<String>

Update an item’s Estimate number field on the project board.

Returns the project item ID (either found or newly added).

pub async fn get_estimates_for_issues( &self, issue_node_ids: &[String], ) -> Result<HashMap<String, u8>>

Batch-fetch estimate values for multiple project items by their content (issue) node IDs.

Returns a map from content node ID → estimate value (0 if not set or field absent). Only queries the estimate field — the result is used to populate orch’s estimate during task ingestion when tasks.estimate is still 0.

GitHub’s GraphQL API doesn’t support querying items by arbitrary node IDs directly, so we fetch all project items and their field values, then match by content ID. This is acceptable for projects with reasonable item counts (< 1000).