From 366546fd745d0727fa98a9f3714b38d30000e167 Mon Sep 17 00:00:00 2001
From: Dachary Carey <dachary.carey@mongodb.com>
Date: Thu, 18 Dec 2025 16:44:29 -0500
Subject: [PATCH] Clarify output related to counts in composable usage

---
 commands/analyze/composables/output.go | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/commands/analyze/composables/output.go b/commands/analyze/composables/output.go
index 5ab6173..c5ece63 100644
--- a/commands/analyze/composables/output.go
+++ b/commands/analyze/composables/output.go
@@ -12,7 +12,8 @@ func PrintResults(result *AnalysisResult, verbose bool, findSimilar bool, findUs
 	fmt.Printf("Composables Analysis\n")
 	fmt.Printf("====================\n\n")
 
-	fmt.Printf("Total composables found: %d\n\n", len(result.AllComposables))
+	fmt.Printf("Total composable definitions found: %d\n", len(result.AllComposables))
+	fmt.Printf("(Each [[composables]] stanza in snooty.toml/rstspec.toml files)\n\n")
 
 	// Print summary by ID
 	printSummaryByID(result)
@@ -349,6 +350,17 @@ func findCommonOptions(locations []ComposableLocation) []ComposableOption {
 
 // printUsageInformation prints usage information for composables.
 func printUsageInformation(composables []ComposableLocation, usages map[string]*ComposableUsage, verbose bool) {
+	// Calculate total unique pages across all composables
+	uniquePages := make(map[string]bool)
+	for _, usage := range usages {
+		for _, filePath := range usage.FilePaths {
+			uniquePages[filePath] = true
+		}
+	}
+
+	// Print total unique pages count
+	fmt.Printf("Total unique pages using composables: %d\n\n", len(uniquePages))
+
 	// Group usages by composable ID
 	usagesByID := make(map[string][]*ComposableUsage)
 	for _, usage := range usages {