Compose resilient CLI processing and report lifecycle

internal/framework/contracts/contracts.go

@@ -45,6 +45,7 @@ type SectionMetadata struct {
 	StartSegmentID  int `json:"start_segment_id"`
 	EndSegmentID    int `json:"end_segment_id"`
 	EstimatedTokens int `json:"estimated_tokens"`
+	SegmentCount    int `json:"segment_count"`
 }
 
 // SectionMetadataFromSection converts a chunking section into framework metadata.
@@ -54,6 +55,7 @@ func SectionMetadataFromSection(section chunking.Section) SectionMetadata {
 		StartSegmentID:  section.StartSegmentID,
 		EndSegmentID:    section.EndSegmentID,
 		EstimatedTokens: section.EstimatedTokens,
+		SegmentCount:    len(section.Segments),
 	}
 }