Rename unrealized tax to pregnant, add combined after-tax value

Unrealized gains section now labeled "Pregnant STCG/LTCG" and
"Total Pregnant Tax". YTD realized section labeled "YTD Realized Tax".
After-Tax Value = Portfolio Value - Total Pregnant Tax - YTD Tax Remaining.

Author: bufdev

cmd/ibctl/internal/command/holding/holdingoverview/holdingoverview.go

@@ -85,10 +85,12 @@ type overviewJSON struct {
 	Categories []*ibctlholdings.CategoryOverview `json:"categories"`
 	// Geos is holdings aggregated by geographic classification.
 	Geos []*ibctlholdings.GeoOverview `json:"geos"`
-	// Value is the portfolio value summary with tax impact.
+	// Value is the portfolio value summary with pregnant (unrealized) tax impact.
 	Value *valueJSON `json:"value"`
 	// YTDTax is the YTD realized income tax summary.
 	YTDTax *ytdTaxJSON `json:"ytd_tax"`
+	// AfterTaxMicros is the after-tax portfolio value (portfolio - pregnant tax - YTD tax remaining).
+	AfterTaxMicros int64 `json:"after_tax_micros"`
 }
 
 // ytdTaxJSON is the YTD realized income tax summary for JSON output.
@@ -125,22 +127,20 @@ type ytdTaxJSON struct {
 	TaxRateLTCG float64 `json:"tax_rate_ltcg"`
 }
 
-// valueJSON is the portfolio value summary for JSON output.
+// valueJSON is the portfolio value summary with pregnant (unrealized) tax for JSON output.
 type valueJSON struct {
 	// PortfolioValueMicros is the total portfolio market value in micros.
 	PortfolioValueMicros int64 `json:"portfolio_value_micros"`
-	// STCGMicros is the total short-term capital gains in micros.
-	STCGMicros int64 `json:"stcg_micros"`
-	// STCGTaxMicros is the estimated short-term capital gains tax in micros.
-	STCGTaxMicros int64 `json:"stcg_tax_micros"`
-	// LTCGMicros is the total long-term capital gains in micros.
-	LTCGMicros int64 `json:"ltcg_micros"`
-	// LTCGTaxMicros is the estimated long-term capital gains tax in micros.
-	LTCGTaxMicros int64 `json:"ltcg_tax_micros"`
-	// TotalTaxMicros is the total estimated tax in micros.
-	TotalTaxMicros int64 `json:"total_tax_micros"`
-	// AfterTaxMicros is the after-tax portfolio value in micros.
-	AfterTaxMicros int64 `json:"after_tax_micros"`
+	// PregnantSTCGMicros is the total pregnant (unrealized) short-term capital gains in micros.
+	PregnantSTCGMicros int64 `json:"pregnant_stcg_micros"`
+	// PregnantSTCGTaxMicros is the estimated pregnant short-term capital gains tax in micros.
+	PregnantSTCGTaxMicros int64 `json:"pregnant_stcg_tax_micros"`
+	// PregnantLTCGMicros is the total pregnant (unrealized) long-term capital gains in micros.
+	PregnantLTCGMicros int64 `json:"pregnant_ltcg_micros"`
+	// PregnantLTCGTaxMicros is the estimated pregnant long-term capital gains tax in micros.
+	PregnantLTCGTaxMicros int64 `json:"pregnant_ltcg_tax_micros"`
+	// TotalPregnantTaxMicros is the total estimated pregnant (unrealized) tax in micros.
+	TotalPregnantTaxMicros int64 `json:"total_pregnant_tax_micros"`
 	// TaxRateSTCG is the short-term capital gains tax rate from config.
 	TaxRateSTCG float64 `json:"tax_rate_stcg"`
 	// TaxRateLTCG is the long-term capital gains tax rate from config.
@@ -200,6 +200,9 @@ func run(ctx context.Context, container appext.Container, flags *flags) error {
 		fmt.Fprintln(writer)
 		// Section 5: YTD realized income tax summary.
 		ibctlcmd.WriteYTDTaxSummary(writer, ytdSummary, data.Config, formatBaseMicros)
+		fmt.Fprintln(writer)
+		// Section 6: combined after-tax value.
+		ibctlcmd.WriteAfterTaxValue(writer, summary, ytdSummary, formatBaseMicros)
 		return nil
 	case cliio.FormatCSV:
 		// Section 1: holding list CSV.
@@ -222,23 +225,27 @@ func run(ctx context.Context, container appext.Container, flags *flags) error {
 		fmt.Fprintln(writer)
 		// Section 5: YTD realized income tax summary.
 		ibctlcmd.WriteYTDTaxSummary(writer, ytdSummary, data.Config, formatBaseMicros)
+		fmt.Fprintln(writer)
+		// Section 6: combined after-tax value.
+		ibctlcmd.WriteAfterTaxValue(writer, summary, ytdSummary, formatBaseMicros)
 		return nil
 	case cliio.FormatJSON:
 		// Combined JSON object with all five sections.
+		// Compute combined after-tax value for JSON output.
+		afterTaxMicros := summary.TotalValueMicros - summary.TotalTaxMicros - ytdSummary.TaxRemainingMicros
 		overview := &overviewJSON{
 			Holdings:   result.Holdings,
 			Categories: categories,
 			Geos:       geos,
 			Value: &valueJSON{
-				PortfolioValueMicros: summary.TotalValueMicros,
-				STCGMicros:           summary.TotalSTCGMicros,
-				STCGTaxMicros:        summary.STCGTaxMicros,
-				LTCGMicros:           summary.TotalLTCGMicros,
-				LTCGTaxMicros:        summary.LTCGTaxMicros,
-				TotalTaxMicros:       summary.TotalTaxMicros,
-				AfterTaxMicros:       summary.AfterTaxMicros,
-				TaxRateSTCG:          data.Config.TaxRateSTCG,
-				TaxRateLTCG:          data.Config.TaxRateLTCG,
+				PortfolioValueMicros:   summary.TotalValueMicros,
+				PregnantSTCGMicros:     summary.TotalSTCGMicros,
+				PregnantSTCGTaxMicros:  summary.STCGTaxMicros,
+				PregnantLTCGMicros:     summary.TotalLTCGMicros,
+				PregnantLTCGTaxMicros:  summary.LTCGTaxMicros,
+				TotalPregnantTaxMicros: summary.TotalTaxMicros,
+				TaxRateSTCG:            data.Config.TaxRateSTCG,
+				TaxRateLTCG:            data.Config.TaxRateLTCG,
 			},
 			YTDTax: &ytdTaxJSON{
 				DividendMicros:     ytdSummary.DividendMicros,
@@ -257,6 +264,7 @@ func run(ctx context.Context, container appext.Container, flags *flags) error {
 				TaxRateSTCG:        data.Config.TaxRateSTCG,
 				TaxRateLTCG:        data.Config.TaxRateLTCG,
 			},
+			AfterTaxMicros: afterTaxMicros,
 		}
 		jsonData, err := json.Marshal(overview)
 		if err != nil {

cmd/ibctl/internal/command/holding/holdingvalue/holdingvalue.go

@@ -103,5 +103,7 @@ func run(ctx context.Context, container appext.Container, flags *flags) error {
 	}
 	fmt.Fprintln(os.Stdout)
 	ibctlcmd.WriteYTDTaxSummary(os.Stdout, ytdSummary, data.Config, formatBaseMicros)
+	fmt.Fprintln(os.Stdout)
+	ibctlcmd.WriteAfterTaxValue(os.Stdout, summary, ytdSummary, formatBaseMicros)
 	return nil
 }

cmd/ibctl/internal/ibctlcmd/holdingsdata.go

@@ -191,10 +191,8 @@ type ValueSummary struct {
 	TotalLTCGMicros int64
 	// LTCGTaxMicros is the estimated long-term capital gains tax in micros.
 	LTCGTaxMicros int64
-	// TotalTaxMicros is the total estimated tax in micros.
+	// TotalTaxMicros is the total estimated pregnant (unrealized) tax in micros.
 	TotalTaxMicros int64
-	// AfterTaxMicros is the after-tax portfolio value in micros.
-	AfterTaxMicros int64
 }
 
 // YTDTaxSummary holds computed YTD realized income and capital gains tax amounts.
@@ -236,16 +234,13 @@ func ComputeValueSummary(holdings []*ibctlholdings.HoldingOverview, config *ibct
 	stcgTaxMicros := int64(math.Round(float64(totalSTCGMicros) * config.TaxRateSTCG))
 	ltcgTaxMicros := int64(math.Round(float64(totalLTCGMicros) * config.TaxRateLTCG))
 	totalTaxMicros := stcgTaxMicros + ltcgTaxMicros
-	// After-tax value = portfolio value - total taxes.
-	afterTaxMicros := totalValueMicros - totalTaxMicros
 	return &ValueSummary{
 		TotalValueMicros: totalValueMicros,
 		TotalSTCGMicros:  totalSTCGMicros,
 		STCGTaxMicros:    stcgTaxMicros,
 		TotalLTCGMicros:  totalLTCGMicros,
 		LTCGTaxMicros:    ltcgTaxMicros,
 		TotalTaxMicros:   totalTaxMicros,
-		AfterTaxMicros:   afterTaxMicros,
 	}
 }
 
@@ -306,35 +301,40 @@ func ComputeYTDTaxSummary(
 	}, nil
 }
 
-// WriteValueSummary writes the portfolio value summary as formatted text.
+// WriteValueSummary writes the portfolio value summary with pregnant (unrealized) tax as formatted text.
 func WriteValueSummary(writer io.Writer, summary *ValueSummary, config *ibctlconfig.Config, formatBaseMicros func(int64) string) {
-	fmt.Fprintf(writer, "Portfolio Value:  %s\n", formatBaseMicros(summary.TotalValueMicros))
+	fmt.Fprintf(writer, "Portfolio Value:           %s\n", formatBaseMicros(summary.TotalValueMicros))
 	fmt.Fprintf(writer, "\n")
-	fmt.Fprintf(writer, "STCG:            %s\n", formatBaseMicros(summary.TotalSTCGMicros))
-	fmt.Fprintf(writer, "STCG Tax (%.1f%%):  %s\n", config.TaxRateSTCG*100, formatBaseMicros(summary.STCGTaxMicros))
-	fmt.Fprintf(writer, "LTCG:            %s\n", formatBaseMicros(summary.TotalLTCGMicros))
-	fmt.Fprintf(writer, "LTCG Tax (%.1f%%):  %s\n", config.TaxRateLTCG*100, formatBaseMicros(summary.LTCGTaxMicros))
-	fmt.Fprintf(writer, "Total Tax:       %s\n", formatBaseMicros(summary.TotalTaxMicros))
-	fmt.Fprintf(writer, "\n")
-	fmt.Fprintf(writer, "After-Tax Value: %s\n", formatBaseMicros(summary.AfterTaxMicros))
+	fmt.Fprintf(writer, "Pregnant STCG:             %s\n", formatBaseMicros(summary.TotalSTCGMicros))
+	fmt.Fprintf(writer, "Pregnant STCG Tax (%.1f%%): %s\n", config.TaxRateSTCG*100, formatBaseMicros(summary.STCGTaxMicros))
+	fmt.Fprintf(writer, "Pregnant LTCG:             %s\n", formatBaseMicros(summary.TotalLTCGMicros))
+	fmt.Fprintf(writer, "Pregnant LTCG Tax (%.1f%%): %s\n", config.TaxRateLTCG*100, formatBaseMicros(summary.LTCGTaxMicros))
+	fmt.Fprintf(writer, "Total Pregnant Tax:        %s\n", formatBaseMicros(summary.TotalTaxMicros))
 }
 
 // WriteYTDTaxSummary writes the YTD realized income tax summary as formatted text.
 func WriteYTDTaxSummary(writer io.Writer, summary *YTDTaxSummary, config *ibctlconfig.Config, formatBaseMicros func(int64) string) {
-	fmt.Fprintf(writer, "YTD Realized Income Tax:\n")
+	fmt.Fprintf(writer, "YTD Realized Tax:\n")
 	fmt.Fprintf(writer, "\n")
-	fmt.Fprintf(writer, "Dividends:              %s\n", formatBaseMicros(summary.DividendMicros))
-	fmt.Fprintf(writer, "Dividend Tax (%.1f%%):   %s\n", config.TaxRateDividend*100, formatBaseMicros(summary.DividendTaxMicros))
-	fmt.Fprintf(writer, "Interest:               %s\n", formatBaseMicros(summary.InterestMicros))
-	fmt.Fprintf(writer, "Interest Tax (%.1f%%):   %s\n", config.TaxRateInterest*100, formatBaseMicros(summary.InterestTaxMicros))
-	fmt.Fprintf(writer, "Realized STCG:          %s\n", formatBaseMicros(summary.STCGMicros))
-	fmt.Fprintf(writer, "STCG Tax (%.1f%%):       %s\n", config.TaxRateSTCG*100, formatBaseMicros(summary.STCGTaxMicros))
-	fmt.Fprintf(writer, "Realized LTCG:          %s\n", formatBaseMicros(summary.LTCGMicros))
-	fmt.Fprintf(writer, "LTCG Tax (%.1f%%):       %s\n", config.TaxRateLTCG*100, formatBaseMicros(summary.LTCGTaxMicros))
+	fmt.Fprintf(writer, "Dividends:                 %s\n", formatBaseMicros(summary.DividendMicros))
+	fmt.Fprintf(writer, "Dividend Tax (%.1f%%):     %s\n", config.TaxRateDividend*100, formatBaseMicros(summary.DividendTaxMicros))
+	fmt.Fprintf(writer, "Interest:                  %s\n", formatBaseMicros(summary.InterestMicros))
+	fmt.Fprintf(writer, "Interest Tax (%.1f%%):     %s\n", config.TaxRateInterest*100, formatBaseMicros(summary.InterestTaxMicros))
+	fmt.Fprintf(writer, "Realized STCG:             %s\n", formatBaseMicros(summary.STCGMicros))
+	fmt.Fprintf(writer, "STCG Tax (%.1f%%):         %s\n", config.TaxRateSTCG*100, formatBaseMicros(summary.STCGTaxMicros))
+	fmt.Fprintf(writer, "Realized LTCG:             %s\n", formatBaseMicros(summary.LTCGMicros))
+	fmt.Fprintf(writer, "LTCG Tax (%.1f%%):         %s\n", config.TaxRateLTCG*100, formatBaseMicros(summary.LTCGTaxMicros))
 	fmt.Fprintf(writer, "\n")
-	fmt.Fprintf(writer, "Total Tax Owed:         %s\n", formatBaseMicros(summary.TotalTaxOwedMicros))
-	fmt.Fprintf(writer, "Tax Paid:               %s\n", formatBaseMicros(summary.TaxPaidMicros))
-	fmt.Fprintf(writer, "Tax Remaining:          %s\n", formatBaseMicros(summary.TaxRemainingMicros))
+	fmt.Fprintf(writer, "YTD Tax Owed:              %s\n", formatBaseMicros(summary.TotalTaxOwedMicros))
+	fmt.Fprintf(writer, "YTD Tax Paid:              %s\n", formatBaseMicros(summary.TaxPaidMicros))
+	fmt.Fprintf(writer, "YTD Tax Remaining:         %s\n", formatBaseMicros(summary.TaxRemainingMicros))
+}
+
+// WriteAfterTaxValue writes the combined after-tax portfolio value.
+// After-tax value = portfolio value - pregnant tax - YTD tax remaining.
+func WriteAfterTaxValue(writer io.Writer, valueSummary *ValueSummary, ytdSummary *YTDTaxSummary, formatBaseMicros func(int64) string) {
+	afterTaxMicros := valueSummary.TotalValueMicros - valueSummary.TotalTaxMicros - ytdSummary.TaxRemainingMicros
+	fmt.Fprintf(writer, "After-Tax Value:           %s\n", formatBaseMicros(afterTaxMicros))
 }
 
 // WriteHoldingListTable writes the holding list as a table with securities,