Add path filters to docs pipeline so it only runs when Guide/ changes

Co-authored-by: benhillis <17727402+benhillis@users.noreply.github.com>

Author: Copilot

.github/workflows/openvmm-docs-ci.yaml

@@ -69,6 +69,10 @@ pub struct PrTrigger {
     pub branches_ignore: Vec<String>,
     #[serde(skip_serializing_if = "Vec::is_empty")]
     pub types: Vec<String>,
+    #[serde(skip_serializing_if = "Vec::is_empty")]
+    pub paths: Vec<String>,
+    #[serde(skip_serializing_if = "Vec::is_empty")]
+    pub paths_ignore: Vec<String>,
 }
 
 #[derive(Debug, Serialize, Deserialize)]
@@ -82,6 +86,10 @@ pub struct CiTrigger {
     pub tags: Vec<String>,
     #[serde(skip_serializing_if = "Vec::is_empty")]
     pub tags_ignore: Vec<String>,
+    #[serde(skip_serializing_if = "Vec::is_empty")]
+    pub paths: Vec<String>,
+    #[serde(skip_serializing_if = "Vec::is_empty")]
+    pub paths_ignore: Vec<String>,
 }
 
 #[derive(Debug, Serialize, Deserialize)]

.github/workflows/openvmm-docs-pr.yaml

@@ -664,6 +664,8 @@ EOF
                     branches: gh_pr_triggers.branches.clone(),
                     branches_ignore: gh_pr_triggers.exclude_branches.clone(),
                     types: gh_pr_triggers.types.clone(),
+                    paths: gh_pr_triggers.paths.clone(),
+                    paths_ignore: gh_pr_triggers.paths_ignore.clone(),
                 })
             }
             None => None,
@@ -674,6 +676,8 @@ EOF
                 branches_ignore: gh_ci_triggers.exclude_branches,
                 tags: gh_ci_triggers.tags,
                 tags_ignore: gh_ci_triggers.exclude_tags,
+                paths: gh_ci_triggers.paths,
+                paths_ignore: gh_ci_triggers.paths_ignore,
             }),
             None => None,
         },

flowey/flowey_cli/src/pipeline_resolver/github_yaml/github_yaml_defs.rs

@@ -254,6 +254,12 @@ pub struct GhPrTriggers {
     pub auto_cancel: bool,
     /// Run the pipeline whenever the PR trigger matches the specified types
     pub types: Vec<String>,
+    /// Only run the pipeline when files matching these paths are changed
+    /// (supports glob syntax)
+    pub paths: Vec<String>,
+    /// Specify any paths which should be filtered out from the list of
+    /// `paths` (supports glob syntax)
+    pub paths_ignore: Vec<String>,
 }
 
 /// Trigger Github Actions pipelines per PR
@@ -271,6 +277,12 @@ pub struct GhCiTriggers {
     /// Specify any tags which should be filtered out from the list of `tags`
     /// (supports glob syntax)
     pub exclude_tags: Vec<String>,
+    /// Only run the pipeline when files matching these paths are changed
+    /// (supports glob syntax)
+    pub paths: Vec<String>,
+    /// Specify any paths which should be filtered out from the list of
+    /// `paths` (supports glob syntax)
+    pub paths_ignore: Vec<String>,
 }
 
 impl GhPrTriggers {
@@ -286,6 +298,8 @@ impl GhPrTriggers {
                 "ready_for_review".into(),
             ],
             auto_cancel: true,
+            paths: Vec::new(),
+            paths_ignore: Vec::new(),
         }
     }
 }

flowey/flowey_cli/src/pipeline_resolver/github_yaml/mod.rs

@@ -40,14 +40,17 @@ impl IntoPipeline for BuildDocsCli {
 
         let mut pipeline = Pipeline::new();
 
-        // The docs pipeline should only run on the main branch.
+        // The docs pipeline should only run on the main branch, and only when
+        // the Guide directory is modified.
         {
             let branches = vec!["main".into()];
+            let paths = vec!["Guide/**".into()];
             match config {
                 PipelineConfig::Ci => {
                     pipeline
                         .gh_set_ci_triggers(GhCiTriggers {
                             branches,
+                            paths,
                             ..Default::default()
                         })
                         .gh_set_name("OpenVMM Docs CI");
@@ -56,6 +59,7 @@ impl IntoPipeline for BuildDocsCli {
                     pipeline
                         .gh_set_pr_triggers(GhPrTriggers {
                             branches,
+                            paths,
                             ..GhPrTriggers::new_draftable()
                         })
                         .gh_set_name("OpenVMM Docs PR");