@paro.io/expert-shared-components 1.14.71 → 1.14.73

package/lib/tax-axis/components/prospectReport/ProspectReportSkeleton.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProspectReportSkeleton = ProspectReportSkeleton;
+const react_1 = __importDefault(require("react"));
+const theme_1 = require("./theme");
+// Dark-themed skeleton shown while generateProspectReport mutation is in-flight
+function Bone({ w = "100%", h = 16, radius = 6, mb = 0 }) {
+    return (react_1.default.createElement("div", { style: {
+            width: w,
+            height: h,
+            borderRadius: radius,
+            background: `linear-gradient(90deg, ${theme_1.T.surface2} 25%, rgba(255,255,255,0.04) 50%, ${theme_1.T.surface2} 75%)`,
+            backgroundSize: "400% 100%",
+            animation: "skeletonShimmer 1.6s infinite linear",
+            marginBottom: mb,
+            flexShrink: 0,
+        } }));
+}
+function ProspectReportSkeleton() {
+    return (react_1.default.createElement(react_1.default.Fragment, null,
+        react_1.default.createElement("style", null, `
+        @keyframes skeletonShimmer {
+          0%   { background-position: 100% 0 }
+          100% { background-position: -100% 0 }
+        }
+      `),
+        react_1.default.createElement("div", { style: { background: theme_1.T.surface, border: `1px solid ${theme_1.T.border}`, borderRadius: 16, padding: "36px 32px 28px", marginBottom: 24, boxShadow: theme_1.T.shadowLg, overflow: "hidden" } },
+            react_1.default.createElement("div", { style: { height: 4, background: `linear-gradient(90deg,${theme_1.T.accent},${theme_1.T.orange})`, marginBottom: 24, borderRadius: 2 } }),
+            react_1.default.createElement("div", { style: { display: "flex", justifyContent: "space-between", marginBottom: 20 } },
+                react_1.default.createElement(Bone, { w: 120, h: 12 }),
+                react_1.default.createElement(Bone, { w: 80, h: 12 })),
+            react_1.default.createElement(Bone, { w: "45%", h: 10, mb: 12 }),
+            react_1.default.createElement(Bone, { w: "70%", h: 36, mb: 12 }),
+            react_1.default.createElement(Bone, { w: "50%", h: 14, mb: 24 }),
+            react_1.default.createElement("div", { style: { height: 1, background: theme_1.T.border, marginBottom: 20 } }),
+            react_1.default.createElement(Bone, { w: "55%", h: 44, mb: 12 }),
+            react_1.default.createElement(Bone, { w: "30%", h: 12 })),
+        react_1.default.createElement("div", { style: { background: theme_1.T.surface, border: `1px solid ${theme_1.T.border}`, borderRadius: 14, padding: "24px 28px", marginBottom: 24, boxShadow: theme_1.T.shadow } },
+            react_1.default.createElement(Bone, { w: "40%", h: 10, mb: 16 }),
+            react_1.default.createElement("div", { style: { display: "grid", gridTemplateColumns: "1fr 1fr 1fr", gap: 16 } }, [1, 2, 3].map(i => (react_1.default.createElement("div", { key: i },
+                react_1.default.createElement(Bone, { w: "60%", h: 28, mb: 8 }),
+                react_1.default.createElement(Bone, { w: "80%", h: 10 })))))),
+        react_1.default.createElement("div", { style: { background: theme_1.T.surface, border: `1px solid ${theme_1.T.border}`, borderRadius: 14, padding: "24px 28px", marginBottom: 24, boxShadow: theme_1.T.shadow } },
+            react_1.default.createElement(Bone, { w: "25%", h: 10, mb: 16 }),
+            react_1.default.createElement("div", { style: { display: "grid", gridTemplateColumns: "1fr 1fr 1fr 1fr", gap: 16 } }, [1, 2, 3, 4].map(i => (react_1.default.createElement("div", { key: i },
+                react_1.default.createElement(Bone, { w: "70%", h: 22, mb: 8 }),
+                react_1.default.createElement(Bone, { w: "80%", h: 10 })))))),
+        react_1.default.createElement("div", { style: { marginBottom: 24 } },
+            react_1.default.createElement(Bone, { w: "30%", h: 10, mb: 12 }),
+            react_1.default.createElement(Bone, { w: "100%", h: 2, mb: 16 }),
+            react_1.default.createElement(Bone, { w: "100%", h: 14, mb: 8 }),
+            react_1.default.createElement(Bone, { w: "95%", h: 14, mb: 8 }),
+            react_1.default.createElement(Bone, { w: "80%", h: 14 })),
+        [1, 2, 3].map(i => (react_1.default.createElement("div", { key: i, style: { background: theme_1.T.surface, border: `1px solid ${theme_1.T.border}`, borderRadius: 14, padding: "24px 28px", marginBottom: 14, boxShadow: theme_1.T.shadow } },
+            react_1.default.createElement("div", { style: { display: "flex", justifyContent: "space-between", marginBottom: 20 } },
+                react_1.default.createElement("div", { style: { display: "flex", gap: 14, alignItems: "center" } },
+                    react_1.default.createElement("div", { style: { width: 34, height: 34, borderRadius: "50%", background: theme_1.T.surface2 } }),
+                    react_1.default.createElement("div", null,
+                        react_1.default.createElement(Bone, { w: 160, h: 16, mb: 8 }),
+                        react_1.default.createElement(Bone, { w: 100, h: 10 }))),
+                react_1.default.createElement("div", { style: { textAlign: "right" } },
+                    react_1.default.createElement(Bone, { w: 90, h: 22, mb: 6 }),
+                    react_1.default.createElement(Bone, { w: 80, h: 10 }))),
+            react_1.default.createElement(Bone, { w: "100%", h: 12, mb: 6 }),
+            react_1.default.createElement(Bone, { w: "90%", h: 12, mb: 6 }),
+            react_1.default.createElement(Bone, { w: "75%", h: 12, mb: 16 }),
+            react_1.default.createElement(Bone, { w: "100%", h: 12, mb: 6 }),
+            react_1.default.createElement(Bone, { w: "85%", h: 12 })))),
+        react_1.default.createElement("div", { style: { display: "flex", alignItems: "center", justifyContent: "center", gap: 10, padding: "20px 0", color: theme_1.T.text4, fontFamily: theme_1.T.body, fontSize: 12 } },
+            react_1.default.createElement("div", { style: { width: 6, height: 6, borderRadius: "50%", background: theme_1.T.accent, animation: "pulse 1s infinite" } }),
+            "Generating your prospect report\u2026"),
+        react_1.default.createElement("style", null, `
+        @keyframes pulse { 0%,100%{opacity:1} 50%{opacity:0.3} }
+      `)));
+}

package/lib/tax-axis/components/prospectReport/ProspectStrategyCard.d.ts

@@ -1,10 +1,16 @@
 import React from "react";
 import type { Strategy, ClientProfile, ComputedMap } from "../../lib/types";
+export interface LlmStrategyNarrative {
+    whyItMatters: string;
+    whatWeDo: string;
+}
 interface ProspectStrategyCardProps {
     strategy: Strategy;
     index: number;
     profile: ClientProfile;
     computed: ComputedMap;
+    /** LLM-generated narrative — when present, overrides all static/computed text */
+    llmNarrative?: LlmStrategyNarrative;
 }
-export declare function ProspectStrategyCard({ strategy: s, index: i, profile, computed }: ProspectStrategyCardProps): React.JSX.Element;
+export declare function ProspectStrategyCard({ strategy: s, index: i, profile, computed, llmNarrative }: ProspectStrategyCardProps): React.JSX.Element;
 export {};

package/lib/tax-axis/components/prospectReport/ProspectStrategyCard.js

@@ -8,17 +8,19 @@ const react_1 = __importDefault(require("react"));
 const strategyNarrative_1 = require("../../lib/data/strategyNarrative");
 const strategyProspect_1 = require("../../lib/data/strategyProspect");
 const theme_1 = require("./theme");
-function ProspectStrategyCard({ strategy: s, index: i, profile, computed }) {
-    var _a, _b;
+function ProspectStrategyCard({ strategy: s, index: i, profile, computed, llmNarrative }) {
+    var _a, _b, _c, _d;
     const p = strategyProspect_1.STRATEGY_PROSPECT[s.rank];
     const narr = strategyNarrative_1.STRATEGY_NARRATIVE[s.rank];
     const c = computed.get(s.rank);
-    const whyText = narr ? narr.whyMatters(profile) : strategyNarrative_1.NARRATIVE_FALLBACK.whyMatters(s);
-    const breakdownText = narr ? narr.breakdown(profile, c) : strategyNarrative_1.NARRATIVE_FALLBACK.breakdown(s, c);
-    const specialistText = (narr === null || narr === void 0 ? void 0 : narr.whySpecialist) || strategyNarrative_1.NARRATIVE_FALLBACK.whySpecialist(s);
-    const nextText = narr ? narr.nextSteps : strategyNarrative_1.NARRATIVE_FALLBACK.nextSteps(s);
     const scaledLo = Math.round(((_a = c === null || c === void 0 ? void 0 : c.lo) !== null && _a !== void 0 ? _a : s.lo) / 1000);
     const scaledHi = Math.round(((_b = c === null || c === void 0 ? void 0 : c.hi) !== null && _b !== void 0 ? _b : s.hi) / 1000);
+    // When LLM narrative is provided, use it for whyItMatters and whatWeDo.
+    // HOW SAVINGS BREAK DOWN and WHY YOU NEED A SPECIALIST remain deterministic.
+    const whyText = (_c = llmNarrative === null || llmNarrative === void 0 ? void 0 : llmNarrative.whyItMatters) !== null && _c !== void 0 ? _c : (narr ? narr.whyMatters(profile) : strategyNarrative_1.NARRATIVE_FALLBACK.whyMatters(s));
+    const breakdownText = narr ? narr.breakdown(profile, c) : strategyNarrative_1.NARRATIVE_FALLBACK.breakdown(s, c);
+    const specialistText = (narr === null || narr === void 0 ? void 0 : narr.whySpecialist) || strategyNarrative_1.NARRATIVE_FALLBACK.whySpecialist(s);
+    const nextText = (_d = llmNarrative === null || llmNarrative === void 0 ? void 0 : llmNarrative.whatWeDo) !== null && _d !== void 0 ? _d : (narr ? narr.nextSteps : strategyNarrative_1.NARRATIVE_FALLBACK.nextSteps(s));
     return (react_1.default.createElement("div", { style: { background: theme_1.T.surface, border: `1px solid ${theme_1.T.border}`, borderRadius: 14, padding: "24px 28px", boxShadow: theme_1.T.shadow } },
         react_1.default.createElement("div", { style: { display: "flex", alignItems: "flex-start", justifyContent: "space-between", marginBottom: 16 } },
             react_1.default.createElement("div", { style: { display: "flex", alignItems: "center", gap: 14 } },

package/lib/tax-axis/components/prospectReport/TaxAxisProspectReport.d.ts

@@ -1,9 +1,41 @@
 import React from "react";
 import type { ClientProfile, TaxAxisScreenProps } from "../../lib/types";
+import type { LlmStrategyNarrative } from "./ProspectStrategyCard";
+/** LLM output payload shape returned by generateProspectReport mutation */
+export interface LlmOutputPayload {
+    execSummary: string;
+    strategyNarratives: Record<string, LlmStrategyNarrative>;
+    additionalStrategiesBlurb: string;
+}
+/** Backend-computed math payload */
+export interface BackendComputePayload {
+    savingsLo: number;
+    savingsHi: number;
+    eligibleCount: number;
+    highPriorityCount: number;
+    quickWinCount: number;
+    gapBlock: {
+        currentTax: number;
+        optimizedTax: number;
+        realizedSavings: number;
+        realizedPctOfCurrent: number;
+        fedRatePct: number;
+        stateRatePct: number;
+    };
+    barData: Array<{
+        name: string;
+        mid: number;
+        pct: number;
+    }>;
+}
 export interface TaxAxisProspectReportProps extends TaxAxisScreenProps {
     profile: ClientProfile;
+    /** When provided (from generateProspectReport mutation), all math comes from backend */
+    backendComputePayload?: BackendComputePayload | null;
+    /** LLM-generated narrative text from the mutation */
+    outputPayload?: LlmOutputPayload | null;
     onUpgrade?: () => void;
     onPresent?: () => void;
     onReset?: () => void;
 }
-export declare function TaxAxisProspectReport({ profile, onUpgrade, onPresent, onReset, }: TaxAxisProspectReportProps): React.JSX.Element;
+export declare function TaxAxisProspectReport({ profile, backendComputePayload, outputPayload, onUpgrade, onPresent, onReset, }: TaxAxisProspectReportProps): React.JSX.Element;

package/lib/tax-axis/components/prospectReport/TaxAxisProspectReport.js

@@ -35,47 +35,48 @@ const SampleAnalysisPreview_1 = require("./SampleAnalysisPreview");
 const ProspectDocuments_1 = require("./ProspectDocuments");
 const ProspectNextSteps_1 = require("./ProspectNextSteps");
 const ProspectPrintView_1 = require("./ProspectPrintView");
-function TaxAxisProspectReport({ profile, onUpgrade, onPresent, onReset, }) {
+function TaxAxisProspectReport({ profile, backendComputePayload, outputPayload, onUpgrade, onPresent, onReset, }) {
+    var _a, _b, _c, _d, _e, _f, _g;
     const bizName = profile.bizName || "Client";
     const [confirmReset, setConfirmReset] = (0, react_1.useState)(false);
     const [printMode, setPrintMode] = (0, react_1.useState)(false);
-    // ═══ ELIGIBLE STRATEGIES ═══
+    // ═══ ELIGIBLE STRATEGIES (client-side, for rendering strategy cards) ═══
     const eligible = (0, react_1.useMemo)(() => (0, compute_1.filterEligibleStrategies)(profile), [profile]);
     const high = eligible.filter(s => s.priority === "HIGH");
     const quick = eligible.filter(s => s.priority === "QUICK WIN");
-    // Top 3 by score for the sales narrative
     const top3 = (0, react_1.useMemo)(() => [...eligible].sort((a, b) => b.score - a.score).slice(0, 3), [eligible]);
     const remaining = eligible.length - top3.length;
     const remainingNames = eligible.filter(s => !top3.includes(s)).slice(0, 4).map(s => s.name);
-    // ═══ SAVINGS RANGE (dynamic computation) ═══
+    // ═══ SAVINGS RANGE — backend-authoritative when available ═══
     const computed = (0, react_1.useMemo)(() => (0, compute_1.computeAllStrategies)(profile), [profile]);
-    const displayLo = Math.round(eligible.reduce((a, s) => { var _a, _b; return a + ((_b = (_a = computed.get(s.rank)) === null || _a === void 0 ? void 0 : _a.lo) !== null && _b !== void 0 ? _b : s.lo); }, 0) / 1000);
-    const displayHi = Math.round(eligible.reduce((a, s) => { var _a, _b; return a + ((_b = (_a = computed.get(s.rank)) === null || _a === void 0 ? void 0 : _a.hi) !== null && _b !== void 0 ? _b : s.hi); }, 0) / 1000);
-    // Savings bar chart data — top 3 strategies with midpoint + percentage
-    const totalMid = eligible.reduce((a, s) => { var _a, _b; const c = computed.get(s.rank); return a + (((_a = c === null || c === void 0 ? void 0 : c.lo) !== null && _a !== void 0 ? _a : s.lo) + ((_b = c === null || c === void 0 ? void 0 : c.hi) !== null && _b !== void 0 ? _b : s.hi)) / 2; }, 0);
-    const barData = top3.map(s => { var _a, _b; const c = computed.get(s.rank); const mid = Math.round((((_a = c === null || c === void 0 ? void 0 : c.lo) !== null && _a !== void 0 ? _a : s.lo) + ((_b = c === null || c === void 0 ? void 0 : c.hi) !== null && _b !== void 0 ? _b : s.hi)) / 2); return { name: s.name, mid, pct: totalMid > 0 ? Math.round(mid / totalMid * 100) : 0 }; });
+    const displayLo = backendComputePayload
+        ? Math.round(backendComputePayload.savingsLo / 1000)
+        : Math.round(eligible.reduce((a, s) => { var _a, _b; return a + ((_b = (_a = computed.get(s.rank)) === null || _a === void 0 ? void 0 : _a.lo) !== null && _b !== void 0 ? _b : s.lo); }, 0) / 1000);
+    const displayHi = backendComputePayload
+        ? Math.round(backendComputePayload.savingsHi / 1000)
+        : Math.round(eligible.reduce((a, s) => { var _a, _b; return a + ((_b = (_a = computed.get(s.rank)) === null || _a === void 0 ? void 0 : _a.hi) !== null && _b !== void 0 ? _b : s.hi); }, 0) / 1000);
+    // ═══ GAP BLOCK — backend-authoritative when available ═══
+    const fedRatePct = (_a = backendComputePayload === null || backendComputePayload === void 0 ? void 0 : backendComputePayload.gapBlock.fedRatePct) !== null && _a !== void 0 ? _a : (parseFloat((profile.federalRate || "24").replace("%", "")) || 24);
+    const stateRatePct = (_b = backendComputePayload === null || backendComputePayload === void 0 ? void 0 : backendComputePayload.gapBlock.stateRatePct) !== null && _b !== void 0 ? _b : (parseFloat(profile.stateRate || "4.95") || 4.95);
+    const currentTax = (_c = backendComputePayload === null || backendComputePayload === void 0 ? void 0 : backendComputePayload.gapBlock.currentTax) !== null && _c !== void 0 ? _c : Math.round(((0, compute_1.parseNum)(profile.netIncome) || Math.round((0, compute_1.parseNum)(profile.revenue) * 0.20))
+        * (fedRatePct + stateRatePct) / 100);
+    const realizedSavings = (_d = backendComputePayload === null || backendComputePayload === void 0 ? void 0 : backendComputePayload.gapBlock.realizedSavings) !== null && _d !== void 0 ? _d : Math.min(Math.round((displayLo + displayHi) / 2 * 1000 * 0.325), Math.round(currentTax * 0.6));
+    const optimizedTax = (_e = backendComputePayload === null || backendComputePayload === void 0 ? void 0 : backendComputePayload.gapBlock.optimizedTax) !== null && _e !== void 0 ? _e : (currentTax - realizedSavings);
+    const realizedPctOfCurrent = (_f = backendComputePayload === null || backendComputePayload === void 0 ? void 0 : backendComputePayload.gapBlock.realizedPctOfCurrent) !== null && _f !== void 0 ? _f : (currentTax > 0 ? Math.round((realizedSavings / currentTax) * 100) : 0);
+    // ═══ BAR CHART DATA ═══
+    const barData = (_g = backendComputePayload === null || backendComputePayload === void 0 ? void 0 : backendComputePayload.barData) !== null && _g !== void 0 ? _g : (() => {
+        const totalMid = eligible.reduce((a, s) => { var _a, _b; const c = computed.get(s.rank); return a + (((_a = c === null || c === void 0 ? void 0 : c.lo) !== null && _a !== void 0 ? _a : s.lo) + ((_b = c === null || c === void 0 ? void 0 : c.hi) !== null && _b !== void 0 ? _b : s.hi)) / 2; }, 0);
+        return top3.map(s => { var _a, _b; const c = computed.get(s.rank); const mid = Math.round((((_a = c === null || c === void 0 ? void 0 : c.lo) !== null && _a !== void 0 ? _a : s.lo) + ((_b = c === null || c === void 0 ? void 0 : c.hi) !== null && _b !== void 0 ? _b : s.hi)) / 2); return { name: s.name, mid, pct: totalMid > 0 ? Math.round(mid / totalMid * 100) : 0 }; });
+    })();
     const maxMid = Math.max(...barData.map(b => b.mid), 1);
-    // ═══ GAP BLOCK MATH — Current vs Optimized tax position ═══
-    const rev = (0, compute_1.parseNum)(profile.revenue);
-    const netIncome = (0, compute_1.parseNum)(profile.netIncome) || Math.round(rev * 0.20);
-    const fedRatePct = parseFloat((profile.federalRate || "24").replace("%", "")) || 24;
-    const stateRatePct = parseFloat(profile.stateRate || "4.95") || 4.95;
-    const combinedRate = (fedRatePct + stateRatePct) / 100;
-    const currentTax = Math.round(netIncome * combinedRate);
-    const theoreticalMidK = (displayLo + displayHi) / 2;
-    const realizedSavings = Math.min(Math.round(theoreticalMidK * 1000 * 0.325), Math.round(currentTax * 0.6));
-    const optimizedTax = currentTax - realizedSavings;
-    const realizedPctOfCurrent = currentTax > 0 ? Math.round((realizedSavings / currentTax) * 100) : 0;
-    // Section numbering — shifts when Additional Strategies section is present
-    const sectionNums = remaining > 0
-        ? { recommended: "02", additional: "03", sample: "04", documents: "05", nextSteps: "06" }
-        : { recommended: "02", additional: null, sample: "03", documents: "04", nextSteps: "05" };
     // ═══ DOCUMENT GROUPING ═══
     const allDocsNeeded = [...new Set(eligible.flatMap(s => { var _a; return ((_a = strategyProspect_1.STRATEGY_PROSPECT[s.rank]) === null || _a === void 0 ? void 0 : _a.docsNeeded) || []; }))];
     const requiredDocs = ["Profit & Loss Statement (current year)", "Balance Sheet (current year)"];
     const recommendedDocs = ["Federal Tax Return (most recent)", "W-2 / Officer Compensation records"];
     const conditionalDocs = allDocsNeeded.filter(d => !requiredDocs.includes(d) && !recommendedDocs.includes(d)).slice(0, 5);
-    // ═══ PRINT HANDLER ═══
+    const sectionNums = remaining > 0
+        ? { recommended: "02", additional: "03", sample: "04", documents: "05", nextSteps: "06" }
+        : { recommended: "02", additional: null, sample: "03", documents: "04", nextSteps: "05" };
     const handlePrint = () => {
         setPrintMode(true);
         requestAnimationFrame(() => {
@@ -86,18 +87,16 @@ function TaxAxisProspectReport({ profile, onUpgrade, onPresent, onReset, }) {
             });
         });
     };
-    // ═══ PRINT MODE — Light theme layout ═══
     if (printMode) {
         return (react_1.default.createElement(ProspectPrintView_1.ProspectPrintView, { profile: profile, bizName: bizName, displayLo: displayLo, displayHi: displayHi, currentTax: currentTax, optimizedTax: optimizedTax, realizedSavings: realizedSavings, realizedPctOfCurrent: realizedPctOfCurrent, fedRatePct: fedRatePct, stateRatePct: stateRatePct, eligible: eligible, high: high, quick: quick, top3: top3, computed: computed, fmtTax: compute_1.fmtTax, fmtSavings: compute_1.fmtSavings, requiredDocs: requiredDocs, recommendedDocs: recommendedDocs, conditionalDocs: conditionalDocs }));
     }
-    // ═══ INTERACTIVE MODE — Dark theme layout ═══
     return (react_1.default.createElement("div", null,
         react_1.default.createElement(ProspectCover_1.ProspectCover, { profile: profile, bizName: bizName, displayLo: displayLo, displayHi: displayHi }),
         react_1.default.createElement(TaxPositionGap_1.TaxPositionGap, { bizName: bizName, currentTax: currentTax, optimizedTax: optimizedTax, realizedSavings: realizedSavings, realizedPctOfCurrent: realizedPctOfCurrent, fedRatePct: fedRatePct, stateRatePct: stateRatePct, eligibleCount: eligible.length, fmtTax: compute_1.fmtTax, fmtSavings: compute_1.fmtSavings }),
         react_1.default.createElement("div", { style: { background: theme_1.T.surface, border: `1px solid ${theme_1.T.border}`, borderRadius: 14, padding: "24px 28px", marginBottom: 24, boxShadow: theme_1.T.shadow } },
             react_1.default.createElement("div", { style: { fontSize: 10, fontWeight: 700, textTransform: "uppercase", letterSpacing: "0.15em", color: theme_1.T.text4, marginBottom: 16, fontFamily: theme_1.T.mono } }, "AT A GLANCE"),
             react_1.default.createElement("div", { style: { display: "grid", gridTemplateColumns: "1fr 1fr 1fr 1fr", gap: 16 } }, [
-                { v: `$${displayLo}K\u2013$${displayHi}K`, l: "Est. Savings" },
+                { v: `$${displayLo}K–$${displayHi}K`, l: "Est. Savings" },
                 { v: String(eligible.length), l: "Strategies Found" },
                 { v: String(high.length), l: "High Impact" },
                 { v: String(quick.length), l: "Quick Wins" },
@@ -109,29 +108,30 @@ function TaxAxisProspectReport({ profile, onUpgrade, onPresent, onReset, }) {
                 react_1.default.createElement("span", { style: { fontSize: 11, fontWeight: 700, color: theme_1.T.accent, fontFamily: theme_1.T.mono } }, "01"),
                 react_1.default.createElement("span", { style: { fontSize: 11, fontWeight: 700, textTransform: "uppercase", letterSpacing: "0.12em", color: theme_1.T.text4, fontFamily: theme_1.T.body } }, "EXECUTIVE SUMMARY")),
             react_1.default.createElement("div", { style: { height: 2, background: theme_1.T.accent, width: 48, marginBottom: 16 } }),
-            react_1.default.createElement("div", { style: { fontSize: 14, color: theme_1.T.text2, fontFamily: theme_1.T.body, lineHeight: 1.8, marginBottom: 12 } },
-                "We evaluated ",
-                bizName,
-                "'s tax position against 25 federal strategies and identified ",
-                react_1.default.createElement("strong", { style: { color: theme_1.T.white } },
-                    eligible.length,
-                    " applicable opportunities"),
-                " with combined estimated savings of ",
-                react_1.default.createElement("strong", { style: { color: theme_1.T.accentLt } },
-                    "$",
-                    displayLo,
-                    "K\u2013$",
-                    displayHi,
-                    "K annually"),
-                ". ",
-                high.length,
-                " strategies could have significant impact."),
-            react_1.default.createElement("div", { style: { fontSize: 14, color: theme_1.T.text2, fontFamily: theme_1.T.body, lineHeight: 1.8 } },
-                "The top ",
-                top3.length,
-                " strategies are detailed below.",
-                quick.length > 0 ? ` ${quick.length} can be implemented this week with no structural changes.` : "",
-                " These are profile-based estimates \u2014 uploading financial documents will refine savings calculations and unlock all 25 strategies.")),
+            (outputPayload === null || outputPayload === void 0 ? void 0 : outputPayload.execSummary) ? (react_1.default.createElement("div", { style: { fontSize: 14, color: theme_1.T.text2, fontFamily: theme_1.T.body, lineHeight: 1.8, marginBottom: 12 } }, outputPayload.execSummary)) : (react_1.default.createElement(react_1.default.Fragment, null,
+                react_1.default.createElement("div", { style: { fontSize: 14, color: theme_1.T.text2, fontFamily: theme_1.T.body, lineHeight: 1.8, marginBottom: 12 } },
+                    "We evaluated ",
+                    bizName,
+                    "'s tax position against 25 federal strategies and identified ",
+                    react_1.default.createElement("strong", { style: { color: theme_1.T.white } },
+                        eligible.length,
+                        " applicable opportunities"),
+                    " with combined estimated savings of ",
+                    react_1.default.createElement("strong", { style: { color: theme_1.T.accentLt } },
+                        "$",
+                        displayLo,
+                        "K\u2013$",
+                        displayHi,
+                        "K annually"),
+                    ". ",
+                    high.length,
+                    " strategies could have significant impact."),
+                react_1.default.createElement("div", { style: { fontSize: 14, color: theme_1.T.text2, fontFamily: theme_1.T.body, lineHeight: 1.8 } },
+                    "The top ",
+                    top3.length,
+                    " strategies are detailed below.",
+                    quick.length > 0 ? ` ${quick.length} can be implemented this week with no structural changes.` : "",
+                    " These are profile-based estimates \u2014 uploading financial documents will refine savings calculations and unlock all 25 strategies.")))),
         react_1.default.createElement("div", { style: { background: theme_1.T.surface, border: `1px solid ${theme_1.T.border}`, borderRadius: 14, padding: "20px 24px", marginBottom: 24, boxShadow: theme_1.T.shadow } },
             react_1.default.createElement("div", { style: { fontSize: 10, fontWeight: 700, color: theme_1.T.text4, textTransform: "uppercase", letterSpacing: "0.12em", marginBottom: 12, fontFamily: theme_1.T.mono } }, "SAVINGS DISTRIBUTION"),
             barData.map((b, i) => (react_1.default.createElement("div", { key: i, style: { display: "flex", alignItems: "center", gap: 10, marginBottom: i < barData.length - 1 ? 8 : 0 } },
@@ -151,7 +151,10 @@ function TaxAxisProspectReport({ profile, onUpgrade, onPresent, onReset, }) {
                 react_1.default.createElement("span", { style: { fontSize: 11, fontWeight: 700, color: theme_1.T.accent, fontFamily: theme_1.T.mono } }, "02"),
                 react_1.default.createElement("span", { style: { fontSize: 11, fontWeight: 700, textTransform: "uppercase", letterSpacing: "0.12em", color: theme_1.T.text4, fontFamily: theme_1.T.body } }, "RECOMMENDED STRATEGIES")),
             react_1.default.createElement("div", { style: { height: 2, background: theme_1.T.accent, width: 48, marginBottom: 16 } }),
-            react_1.default.createElement("div", { style: { display: "flex", flexDirection: "column", gap: 14 } }, top3.map((s, i) => (react_1.default.createElement(ProspectStrategyCard_1.ProspectStrategyCard, { key: s.rank, strategy: s, index: i, profile: profile, computed: computed }))))),
+            react_1.default.createElement("div", { style: { display: "flex", flexDirection: "column", gap: 14 } }, top3.map((s, i) => {
+                var _a;
+                return (react_1.default.createElement(ProspectStrategyCard_1.ProspectStrategyCard, { key: s.rank, strategy: s, index: i, profile: profile, computed: computed, llmNarrative: (_a = outputPayload === null || outputPayload === void 0 ? void 0 : outputPayload.strategyNarratives) === null || _a === void 0 ? void 0 : _a[`S${s.rank}`] }));
+            }))),
         remaining > 0 && (react_1.default.createElement("div", { style: { marginBottom: 24 } },
             react_1.default.createElement("div", { style: { display: "flex", alignItems: "baseline", gap: 10, marginBottom: 6 } },
                 react_1.default.createElement("span", { style: { fontSize: 11, fontWeight: 700, color: theme_1.T.accent, fontFamily: theme_1.T.mono } }, "03"),
@@ -162,10 +165,8 @@ function TaxAxisProspectReport({ profile, onUpgrade, onPresent, onReset, }) {
                     "+ ",
                     remaining,
                     " more strategies identified"),
-                react_1.default.createElement("div", { style: { fontSize: 13, color: theme_1.T.text2, fontFamily: theme_1.T.body, lineHeight: 1.7, marginBottom: 10 } },
-                    "Including: ",
-                    remainingNames.join(", "),
-                    remaining > 4 ? " and more" : ""),
+                react_1.default.createElement("div", { style: { fontSize: 13, color: theme_1.T.text2, fontFamily: theme_1.T.body, lineHeight: 1.7, marginBottom: 10 } }, (outputPayload === null || outputPayload === void 0 ? void 0 : outputPayload.additionalStrategiesBlurb)
+                    || `Including: ${remainingNames.join(", ")}${remaining > 4 ? " and more" : ""}`),
                 react_1.default.createElement("div", { style: { fontSize: 12, color: theme_1.T.text3, fontFamily: theme_1.T.body, lineHeight: 1.6, borderLeft: `3px solid ${theme_1.T.accent}`, paddingLeft: 12 } }, "Full analysis with documents unlocks specific savings estimates for every eligible strategy.")))),
         react_1.default.createElement(SampleAnalysisPreview_1.SampleAnalysisPreview, { sectionNum: sectionNums.sample, eligibleCount: eligible.length }),
         react_1.default.createElement(ProspectDocuments_1.ProspectDocuments, { sectionNum: sectionNums.documents, requiredDocs: requiredDocs, recommendedDocs: recommendedDocs, conditionalDocs: conditionalDocs }),

package/lib/tax-axis/lib/adapters/useEngineOutput.js

@@ -25,6 +25,42 @@ for (const s of data_1.STRATEGIES) {
     CATEGORY_BY_RANK.set(s.rank, s.cat);
     CODE_BY_RANK.set(s.rank, s.code);
 }
+// Deterministic timeline bucket assignment by strategy number.
+// Overrides LLM-assigned buckets to ensure consistent reports across runs.
+// Bucket assignment logic:
+//   now:  CPA can action in <2 hours, no external coordination needed
+//   30d:  Requires professional setup, plan changes, or payroll adjustments
+//   90d:  Requires specialist studies, amended returns, or multi-party coordination
+const TIMELINE_BUCKET_BY_STRATEGY = {
+    // --- THIS WEEK: Documentation, reclassification, simple calculations ---
+    10: "now", // S10 Business Meals §274 — reclassify existing expenses
+    11: "now", // S11 Home Office §280A — calculate deduction, measure space
+    13: "now", // S13 Augusta Rule §280A(g) — document rental days
+    17: "now", // S17 Vehicle Expense §274 — review mileage logs, elect method
+    // --- WITHIN 30 DAYS: Professional action, plan setup, payroll changes ---
+    1: "30d", // S1  S-Corp Salary §3121 — BLS benchmarking memo, payroll adjustment
+    2: "30d", // S2  Section 179 — asset purchase timing, election
+    3: "30d", // S3  Bonus Depreciation §168(k) — election decision
+    7: "30d", // S7  Retirement §401(k) — plan design review, contribution change
+    9: "30d", // S9  HSA §223 — enrollment, contribution adjustment
+    12: "30d", // S12 Accountable Plan §62 — establish/update plan document
+    14: "30d", // S14 Family Employment §73 — payroll onboarding, age verification
+    21: "30d", // S21 Tips Deduction (OBBBA) — payroll system update
+    22: "30d", // S22 Overtime Deduction (OBBBA) — payroll system update
+    25: "30d", // S25 Trump Accounts (OBBBA) — account establishment
+    // --- WITHIN 90 DAYS: Specialist study, amended returns, multi-party coordination ---
+    4: "90d", // S4  QBI §199A — SSTB analysis, entity structure review
+    5: "90d", // S5  R&D Credit §41 — specialist study, Form 6765 prep
+    6: "90d", // S6  WOTC §51 — certification process, hiring program setup
+    8: "90d", // S8  Cost Segregation §168 — engineering study required
+    15: "90d", // S15 PTE/SALT — state election filing, deadline coordination
+    16: "90d", // S16 §179D Energy — energy efficiency certification required
+    18: "90d", // S18 Insurance §79/§264 — carrier coordination, policy restructuring
+    19: "90d", // S19 §1031 Like-Kind — qualified intermediary, identification periods
+    20: "90d", // S20 QSBS §1202 — stock qualification analysis, holding period review
+    23: "90d", // S23 §174A R&E Catch-Up — amended returns for 2022-2024
+    24: "90d", // S24 Childcare §45F — facility/program establishment
+};
 // ---------------------------------------------------------------------------
 // Core mapping — engine strategy_analysis entry -> canonical Strategy
 // ---------------------------------------------------------------------------
@@ -48,9 +84,9 @@ function mapAnalysisToStrategy(sa, idx, pc) {
     const formsFromTrace = Array.isArray(ct.forms_required)
         ? ct.forms_required.join(", ")
         : undefined;
-    // Timeline bucket: derive from priority as a reasonable default
     const priority = (sa.priority_tier || "MEDIUM").toUpperCase();
-    const timelineBucket = sa.quick_win ? "now" : priority === "HIGH" ? "now" : priority === "MEDIUM" ? "30d" : "90d";
+    // Deterministic bucket from static map; falls back to "30d" for unknown strategies.
+    const timelineBucket = TIMELINE_BUCKET_BY_STRATEGY[strategyNumber !== null && strategyNumber !== void 0 ? strategyNumber : 0] || "30d";
     return {
         rank: idx + 1,
         strategyNumber: strategyNumber !== null && strategyNumber !== void 0 ? strategyNumber : undefined,
@@ -64,7 +100,7 @@ function mapAnalysisToStrategy(sa, idx, pc) {
         entities: [],
         lo,
         hi,
-        timeline: timelineBucket === "now" ? "Act now" : timelineBucket === "30d" ? "Within 30 days" : "Within 90 days",
+        timeline: timelineBucket === "now" ? "This week" : timelineBucket === "30d" ? "Within 30 days" : timelineBucket === "filing" ? "At filing" : "Within 90 days",
         timelineBucket,
         abstract: sa.engagement_recommendation || "",
         warning: (_j = sa.risk_disclosure) !== null && _j !== void 0 ? _j : null,

package/lib/tax-axis/lib/documentFieldCatalog.d.ts

@@ -1,18 +1,13 @@
-export interface CatalogFieldDef {
-    label?: string;
+export interface FieldDef {
+    label: string;
     sourceRef?: string;
 }
 export interface CatalogSection {
     head: string;
     fields: string[];
 }
-export interface CatalogEntry {
+export interface DocumentCatalogEntry {
     sections: CatalogSection[];
-    fields: Record<string, CatalogFieldDef>;
+    fields: Record<string, FieldDef>;
 }
-/**
- * Keyed by documentType string returned by the backend in parsedData.documentType.
- * When DocumentReviewModal receives parsedData, it looks up the documentType here
- * to get section groupings and field labels. Falls back to flat rendering if no entry.
- */
-export declare const DOCUMENT_FIELD_CATALOG: Record<string, CatalogEntry>;
+export declare const DOCUMENT_FIELD_CATALOG: Record<string, DocumentCatalogEntry>;