Ignore parking lot docs in doc dag

Author: easel

internal/dun/doc_dag.go

@@ -215,6 +215,9 @@ func loadDocNodes(root string) (map[string]*DocNode, map[string]*DocNode, []Issu
 		if !frontmatter.HasFrontmatter || strings.TrimSpace(frontmatter.Dun.ID) == "" {
 			return nil
 		}
+		if frontmatter.Dun.ParkingLot {
+			return nil
+		}
 		if frontmatter.Dun.Review.Deps == nil {
 			frontmatter.Dun.Review.Deps = make(map[string]string)
 		}

internal/dun/doc_dag_test.go

@@ -355,3 +355,49 @@ dun:
 		t.Fatalf("expected invalid issue, got %#v", graph.Issues)
 	}
 }
+
+func TestBuildDocGraphSkipsParkingLotDocs(t *testing.T) {
+	root := t.TempDir()
+	parkedDir := filepath.Join(root, "docs", "helix", "02-design", "adr")
+	if err := os.MkdirAll(parkedDir, 0755); err != nil {
+		t.Fatalf("mkdir parked dir: %v", err)
+	}
+	activeDir := filepath.Join(root, "docs", "helix", "01-frame")
+	if err := os.MkdirAll(activeDir, 0755); err != nil {
+		t.Fatalf("mkdir active dir: %v", err)
+	}
+
+	parked := `---
+dun:
+  id: ADR-008
+  parking_lot: true
+  depends_on:
+    - PRD-001
+---
+# Parked ADR
+`
+	if err := os.WriteFile(filepath.Join(parkedDir, "ADR-008-parked.md"), []byte(parked), 0644); err != nil {
+		t.Fatalf("write parked: %v", err)
+	}
+
+	active := `---
+dun:
+  id: PRD-001
+---
+# PRD
+`
+	if err := os.WriteFile(filepath.Join(activeDir, "prd.md"), []byte(active), 0644); err != nil {
+		t.Fatalf("write active: %v", err)
+	}
+
+	graph, err := buildDocGraph(root)
+	if err != nil {
+		t.Fatalf("build graph: %v", err)
+	}
+	if _, ok := graph.Nodes["ADR-008"]; ok {
+		t.Fatalf("expected parking lot doc to be skipped")
+	}
+	if _, ok := graph.Nodes["PRD-001"]; !ok {
+		t.Fatalf("expected active doc to be included")
+	}
+}

internal/dun/frontmatter.go

@@ -16,11 +16,12 @@ type Frontmatter struct {
 }
 
 type DunFrontmatter struct {
-	ID        string    `yaml:"id"`
-	DependsOn []string  `yaml:"depends_on"`
-	Prompt    string    `yaml:"prompt"`
-	Inputs    []string  `yaml:"inputs"`
-	Review    DocReview `yaml:"review"`
+	ID          string    `yaml:"id"`
+	DependsOn   []string  `yaml:"depends_on"`
+	Prompt      string    `yaml:"prompt"`
+	Inputs      []string  `yaml:"inputs"`
+	Review      DocReview `yaml:"review"`
+	ParkingLot  bool      `yaml:"parking_lot"`
 }
 
 type DocReview struct {

internal/dun/frontmatter_test.go

@@ -16,6 +16,7 @@ dun:
   prompt: prompts/test.md
   inputs:
     - node:parent.doc
+  parking_lot: true
   review:
     self_hash: abc123
     deps:
@@ -43,6 +44,9 @@ Body`
 	if len(frontmatter.Dun.Inputs) != 1 || frontmatter.Dun.Inputs[0] != "node:parent.doc" {
 		t.Fatalf("unexpected inputs: %#v", frontmatter.Dun.Inputs)
 	}
+	if !frontmatter.Dun.ParkingLot {
+		t.Fatalf("expected parking_lot true")
+	}
 	if frontmatter.Dun.Review.SelfHash != "abc123" {
 		t.Fatalf("unexpected self hash: %q", frontmatter.Dun.Review.SelfHash)
 	}