@taskforcehq/taskforce 0.3.303 → 0.3.304

package/dist/components/task/taskKanbanDropRules.test.js

@@ -0,0 +1,114 @@
+import { describe, expect, it } from 'vitest';
+import { buildBacklogDropUpdates, buildScheduleDropResult, buildScheduledDayDropUpdates, buildStatusTransitionUpdates, } from './taskKanbanDropRules';
+const makeTask = (overrides = {}) => ({
+    id: 'task-1',
+    title: 'Task',
+    description: null,
+    category: 'default',
+    type: 'feature',
+    priority: 2,
+    status: 'task',
+    createdAt: '2026-01-01T00:00:00.000Z',
+    ...overrides,
+});
+const toMap = (pairs) => new Map(pairs.map((pair) => [pair.taskId, pair.updates]));
+describe('taskKanbanDropRules', () => {
+    it('reorders backlog tasks and recalculates orderInDay', () => {
+        const activeTask = makeTask({ id: 'task-2' });
+        const result = toMap(buildBacklogDropUpdates({
+            activeTask,
+            sourceColumnId: 'backlog',
+            targetTasks: [makeTask({ id: 'task-1' }), makeTask({ id: 'task-3' })],
+            sourceTasks: [makeTask({ id: 'task-1' }), makeTask({ id: 'task-3' })],
+            insertAt: 1,
+        }));
+        expect(result.get('task-1')).toEqual({ orderInDay: 0 });
+        expect(result.get('task-2')).toEqual({ orderInDay: 1 });
+        expect(result.get('task-3')).toEqual({ orderInDay: 2 });
+    });
+    it('moving scheduled task to backlog clears scheduled fields', () => {
+        const activeTask = makeTask({ id: 'task-2', scheduledDate: '2026-04-14', scheduledWeekKey: '2026-W16' });
+        const result = toMap(buildBacklogDropUpdates({
+            activeTask,
+            sourceColumnId: 'mon',
+            targetTasks: [makeTask({ id: 'task-1' })],
+            sourceTasks: [],
+            insertAt: 1,
+        }));
+        expect(result.get('task-2')).toEqual({
+            scheduledDate: null,
+            scheduledWeekKey: null,
+            orderInDay: 1,
+        });
+    });
+    it('moving task into a scheduled day sets scheduled fields and reindexes source column', () => {
+        const activeTask = makeTask({ id: 'task-3' });
+        const result = toMap(buildScheduledDayDropUpdates({
+            activeTask,
+            sourceColumnId: 'backlog',
+            targetColumnId: 'mon',
+            targetTasks: [makeTask({ id: 'task-1' })],
+            sourceTasks: [makeTask({ id: 'task-2' })],
+            insertAt: 1,
+            scheduledDate: '2026-04-14',
+            scheduledWeekKey: '2026-W16',
+        }));
+        expect(result.get('task-3')).toEqual({
+            scheduledDate: '2026-04-14',
+            scheduledWeekKey: '2026-W16',
+            orderInDay: 1,
+        });
+        expect(result.get('task-2')).toEqual({ orderInDay: 0 });
+    });
+    it('blocks non-terminal tasks from being scheduled into the past', () => {
+        const result = buildScheduleDropResult({
+            activeTask: makeTask({ id: 'task-3', status: 'task' }),
+            sourceColumnId: 'backlog',
+            targetColumnId: 'mon',
+            targetTasks: [],
+            sourceTasks: [],
+            overTaskId: null,
+            isBelowOverItem: false,
+            scheduleDates: {
+                mon: '2026-04-13',
+                tue: '2026-04-14',
+                wed: '2026-04-15',
+                thu: '2026-04-16',
+                fri: '2026-04-17',
+                sat: '2026-04-18',
+                sun: '2026-04-19',
+            },
+            parseToIsoWeekKey: () => '2026-W16',
+            todayDate: '2026-04-14',
+        });
+        expect(result).toEqual({ kind: 'blocked', reason: 'Only completed work can be scheduled in the past.' });
+    });
+    it('preserves cancelled grouping as a no-op for completed column drops', () => {
+        const task = makeTask({ id: 'task-cancelled', status: 'cancelled', completedAt: '2026-04-01T00:00:00.000Z' });
+        expect(buildStatusTransitionUpdates(task, 'completed', '2026-04-14T07:00:00.000Z')).toBeNull();
+    });
+    it('stamps completedAt when moving into completed', () => {
+        const nowIso = '2026-04-14T07:00:00.000Z';
+        const result = buildStatusTransitionUpdates(makeTask({ id: 'task-done' }), 'completed', nowIso);
+        expect(result).toEqual({
+            status: 'done',
+            inProgress: false,
+            readyForReview: false,
+            completed: true,
+            cancelled: false,
+            completedAt: nowIso,
+        });
+    });
+    it('resets review and progress flags when moving back to reviewable workflow states', () => {
+        const nowIso = '2026-04-14T07:00:00.000Z';
+        const result = buildStatusTransitionUpdates(makeTask({ id: 'task-review', status: 'done', inProgress: true, readyForReview: true, completed: true }), 'review', nowIso);
+        expect(result).toEqual({
+            status: 'review',
+            inProgress: false,
+            readyForReview: true,
+            completed: false,
+            cancelled: false,
+            completedAt: null,
+        });
+    });
+});

package/dist/components/ui/Modal.d.ts

@@ -5,7 +5,7 @@ interface ModalProps {
     title: React.ReactNode;
     children: React.ReactNode;
     footer?: React.ReactNode;
-    size?: 'sm' | 'md' | 'lg' | 'xl' | 'full';
+    size?: 'sm' | 'md' | 'mdWide' | 'lg' | 'xl' | 'full';
     theme?: 'light' | 'dawn' | 'dark' | 'midnight';
     className?: string;
     headerActions?: React.ReactNode;

package/dist/components/ui/Modal.js

@@ -36,6 +36,7 @@ export function Modal({ isOpen, onClose, title, children, footer, size = 'md', t
     const sizeClassMap = {
         sm: styles.modalSizeSm,
         md: styles.modalSizeMd,
+        mdWide: styles.modalSizeMdWide,
         lg: styles.modalSizeLg,
         xl: styles.modalSizeXl,
         full: styles.modalSizeFull

package/dist/components/views/AppShellHeader.js

@@ -7,6 +7,10 @@ import favicon from '../../assets/favicon/favicon.svg';
 import { DEFAULT_TASKFORCE_THEME, isLightThemeFamily } from '../../utils/theme';
 export function AppShellHeader({ projectName, currentWorkspaceId, brandLabel = 'TaskForce', runtimeMode = 'local', theme = DEFAULT_TASKFORCE_THEME, meta, actions }) {
     const logo = isLightThemeFamily(theme) ? logoDark : logoLight;
+    const normalizedProjectName = String(projectName || '').trim();
+    const normalizedWorkspaceId = String(currentWorkspaceId || '').trim().toLowerCase();
+    const showProjectName = Boolean(normalizedProjectName
+        && (runtimeMode !== 'cloud' || (normalizedWorkspaceId && normalizedWorkspaceId !== 'default')));
     return (_jsxs("div", { className: `${styles.header} ${shellStyles.standaloneHeader}`, children: [_jsxs("div", { className: `${styles.headerTitle} ${shellStyles.standaloneTitle}`, children: [_jsx("img", { src: logo, alt: "Taskforce Logo", className: styles.brandIcon, onError: (event) => {
                             const target = event.currentTarget;
                             if (target.src !== favicon) {
@@ -15,5 +19,5 @@ export function AppShellHeader({ projectName, currentWorkspaceId, brandLabel = '
                             else {
                                 target.style.display = 'none';
                             }
-                        } }), _jsx("span", { children: brandLabel }), runtimeMode === 'cloud' && (_jsx("span", { className: styles.brandCloudSuffix, children: "HQ" })), projectName && (_jsxs(_Fragment, { children: [_jsx("span", { className: styles.projectSlash, children: "/" }), _jsx("span", { className: styles.projectName, title: currentWorkspaceId ? `Workspace ID: ${currentWorkspaceId}` : undefined, children: projectName })] })), meta] }), _jsx("div", { className: styles.headerActions, style: { gap: '16px' }, children: actions })] }));
+                        } }), _jsx("span", { children: brandLabel }), runtimeMode === 'cloud' && (_jsx("span", { className: styles.brandCloudSuffix, children: "HQ" })), showProjectName && (_jsxs(_Fragment, { children: [_jsx("span", { className: styles.projectSlash, children: "/" }), _jsx("span", { className: styles.projectName, title: currentWorkspaceId ? `Workspace ID: ${currentWorkspaceId}` : undefined, children: normalizedProjectName })] })), meta] }), _jsx("div", { className: styles.headerActions, style: { gap: '16px' }, children: actions })] }));
 }

package/dist/components/views/AppShellHeader.test.js

@@ -18,4 +18,8 @@ describe('AppShellHeader', () => {
         render(_jsx(AppShellHeader, { runtimeMode: "local", theme: "dawn" }));
         expect(screen.getByAltText('Taskforce Logo')).toHaveAttribute('src', logoDark);
     });
+    it('hides a stale project label while cloud runtime is still on the default workspace', () => {
+        render(_jsx(AppShellHeader, { runtimeMode: "cloud", projectName: "Old Workspace", currentWorkspaceId: "default" }));
+        expect(screen.queryByText('Old Workspace')).not.toBeInTheDocument();
+    });
 });

package/dist/components/views/PlanComparisonPage.d.ts

@@ -58,16 +58,17 @@ interface PlanComparisonPageProps {
     canManageCurrentPlan?: boolean;
     pricingEndpoint?: string;
     statusBanner?: {
-        type: 'success' | 'error';
+        type: 'success' | 'error' | 'info';
         message: string;
     } | null;
     onBack: () => void;
     backLabel: string;
+    backDisabled?: boolean;
     topActions?: React.ReactNode;
     shellOwnsScroll?: boolean;
     showPageBackButton?: boolean;
     fallbackPricingSource?: PricingSourceDetails | null;
     onSelectPlan: (intent: PlanSelectionIntent) => void | Promise<void>;
 }
-export declare function PlanComparisonPage({ heading, subtitle, variant, chrome, footer, isAuthenticated, authSessionResolved, currentPlanId, currentPlanVersionId, currentEntitlementState, canManageCurrentPlan, pricingEndpoint, statusBanner, onBack, backLabel, topActions, shellOwnsScroll, showPageBackButton, fallbackPricingSource, onSelectPlan }: PlanComparisonPageProps): import("react/jsx-runtime").JSX.Element;
+export declare function PlanComparisonPage({ heading, subtitle, variant, chrome, footer, isAuthenticated, authSessionResolved, currentPlanId, currentPlanVersionId, currentEntitlementState, canManageCurrentPlan, pricingEndpoint, statusBanner, onBack, backLabel, backDisabled, topActions, shellOwnsScroll, showPageBackButton, fallbackPricingSource, onSelectPlan }: PlanComparisonPageProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/views/PlanComparisonPage.js

@@ -64,7 +64,7 @@ function isActiveEntitlementState(raw) {
     const value = String(raw || '').trim().toLowerCase();
     return value === 'active' || value === 'trialing' || value === 'grace';
 }
-export function PlanComparisonPage({ heading, subtitle, variant = 'app', chrome, footer, isAuthenticated, authSessionResolved = true, currentPlanId, currentPlanVersionId, currentEntitlementState, canManageCurrentPlan = true, pricingEndpoint, statusBanner, onBack, backLabel, topActions, shellOwnsScroll = false, showPageBackButton = true, fallbackPricingSource = null, onSelectPlan }) {
+export function PlanComparisonPage({ heading, subtitle, variant = 'app', chrome, footer, isAuthenticated, authSessionResolved = true, currentPlanId, currentPlanVersionId, currentEntitlementState, canManageCurrentPlan = true, pricingEndpoint, statusBanner, onBack, backLabel, backDisabled = false, topActions, shellOwnsScroll = false, showPageBackButton = true, fallbackPricingSource = null, onSelectPlan }) {
     const [plans, setPlans] = useState([]);
     const [pricingSource, setPricingSource] = useState(null);
     const [loading, setLoading] = useState(true);
@@ -130,7 +130,9 @@ export function PlanComparisonPage({ heading, subtitle, variant = 'app', chrome,
     if (error) {
         return wrapPage(_jsx(_Fragment, { children: _jsx("div", { className: contentClassName, children: _jsx("div", { className: styles.contentFrame, children: _jsxs("div", { className: styles.emptyState, children: [_jsx("h2", { children: "Connecting to plan pricing..." }), _jsx("p", { children: error }), _jsx("button", { className: styles.backBtn, onClick: () => setRetryNonce((value) => value + 1), children: "Retry" })] }) }) }) }));
     }
-    return wrapPage(_jsx(_Fragment, { children: _jsx("div", { className: contentClassName, children: _jsxs("div", { className: styles.contentFrame, children: [_jsxs("div", { className: styles.header, children: [!chrome && (showPageBackButton || topActions) && (_jsxs("div", { className: styles.headerBar, children: [_jsx("div", { children: showPageBackButton ? (_jsx("button", { className: styles.backBtn, onClick: onBack, children: backLabel })) : null }), _jsx("div", { className: styles.headerActions, children: topActions })] })), _jsx("h1", { className: styles.title, children: heading }), subtitle && _jsx("p", { className: styles.subtitle, children: subtitle }), isDebugModeEnabled() && pricingSourceLabel ? (_jsxs("p", { className: styles.debugMeta, children: ["Pricing source: ", pricingSourceLabel] })) : null, statusBanner && (_jsx("div", { className: `${styles.statusBanner} ${statusBanner.type === 'success' ? styles.successBanner : styles.errorBanner}`, children: statusBanner.message }))] }), sortedPlans.length === 0 ? (_jsxs("div", { className: `${styles.emptyState} ${styles.marketingEmptyState}`, children: [_jsx("span", { className: styles.emptyBadge, children: "Coming Soon" }), _jsx("h2", { children: "Paid plans are getting their final polish." }), _jsx("p", { children: "Taskforce pricing is on the way with flexible options for solo operators, teams, and larger rollouts. Check back soon for launch tiers, feature bundles, and early access details." }), _jsxs("div", { className: styles.emptyHighlights, "aria-label": "Upcoming pricing highlights", children: [_jsx("span", { children: "Launch-ready tiers" }), _jsx("span", { children: "Team billing controls" }), _jsx("span", { children: "Feature-based packaging" })] })] })) : (_jsx("div", { className: styles.grid, children: sortedPlans.map((plan) => {
+    return wrapPage(_jsx(_Fragment, { children: _jsx("div", { className: contentClassName, children: _jsxs("div", { className: styles.contentFrame, children: [_jsxs("div", { className: styles.header, children: [!chrome && (showPageBackButton || topActions) && (_jsxs("div", { className: styles.headerBar, children: [_jsx("div", { children: showPageBackButton ? (_jsx("button", { className: styles.backBtn, onClick: onBack, disabled: backDisabled, children: backLabel })) : null }), _jsx("div", { className: styles.headerActions, children: topActions })] })), _jsx("h1", { className: styles.title, children: heading }), subtitle && _jsx("p", { className: styles.subtitle, children: subtitle }), isDebugModeEnabled() && pricingSourceLabel ? (_jsxs("p", { className: styles.debugMeta, children: ["Pricing source: ", pricingSourceLabel] })) : null, statusBanner && (_jsx("div", { className: `${styles.statusBanner} ${statusBanner.type === 'success'
+                                    ? styles.successBanner
+                                    : (statusBanner.type === 'info' ? styles.infoBanner : styles.errorBanner)}`, children: statusBanner.message }))] }), sortedPlans.length === 0 ? (_jsxs("div", { className: `${styles.emptyState} ${styles.marketingEmptyState}`, children: [_jsx("span", { className: styles.emptyBadge, children: "Coming Soon" }), _jsx("h2", { children: "Paid plans are getting their final polish." }), _jsx("p", { children: "Taskforce pricing is on the way with flexible options for solo operators, teams, and larger rollouts. Check back soon for launch tiers, feature bundles, and early access details." }), _jsxs("div", { className: styles.emptyHighlights, "aria-label": "Upcoming pricing highlights", children: [_jsx("span", { children: "Launch-ready tiers" }), _jsx("span", { children: "Team billing controls" }), _jsx("span", { children: "Feature-based packaging" })] })] })) : (_jsx("div", { className: styles.grid, children: sortedPlans.map((plan) => {
                             const monthPrice = plan.pricing.month;
                             const yearPrice = plan.pricing.year;
                             const hasMonth = isSelectablePrice(monthPrice);

package/dist/components/views/PlanComparisonPage.test.js

@@ -97,6 +97,10 @@ describe('PlanComparisonPage', () => {
         expect(await screen.findByRole('heading', { name: 'Subscription Plans' })).toBeInTheDocument();
         expect(screen.queryByText('Current Plan')).not.toBeInTheDocument();
     });
+    it('can disable the page back button while onboarding remains blocked', async () => {
+        render(_jsx(PlanComparisonPage, { heading: "Subscription Plans", isAuthenticated: true, onBack: () => { }, backLabel: "Back to App", backDisabled: true, onSelectPlan: () => { } }));
+        expect(await screen.findByRole('button', { name: 'Back to App' })).toBeDisabled();
+    });
     it('selects the whole plan card using the default available interval', async () => {
         const onSelectPlan = vi.fn();
         render(_jsx(PlanComparisonPage, { heading: "Subscription Plans", isAuthenticated: false, onBack: () => { }, backLabel: "Back", onSelectPlan: onSelectPlan }));

package/dist/components/views/PlansPage.d.ts

@@ -1,3 +1,4 @@
+import { type AccountProfileSummary } from '../../utils/accountProfileSummaryCache';
 interface PlansPageProps {
     isAuthenticated: boolean;
     authUserId?: string | null;
@@ -11,6 +12,9 @@ interface PlansPageProps {
     resolveCloudAuthUrl?: (path: string) => string;
     embedded?: boolean;
     shellOwnsScroll?: boolean;
+    onAccountProfileSummaryChange?: (summary: AccountProfileSummary | null) => void;
+    onContinueToTaskforce?: () => void | Promise<void>;
+    continueBusy?: boolean;
 }
-export declare function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessionResolved, currentTheme, projectName, currentWorkspaceId, apiBaseUrl, connectedEnvironmentSource, resolveCloudAuthUrl, embedded, shellOwnsScroll }: PlansPageProps): import("react/jsx-runtime").JSX.Element;
+export declare function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessionResolved, currentTheme, projectName, currentWorkspaceId, apiBaseUrl, connectedEnvironmentSource, resolveCloudAuthUrl, embedded, shellOwnsScroll, onAccountProfileSummaryChange, onContinueToTaskforce, continueBusy }: PlansPageProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/views/PlansPage.js

@@ -38,7 +38,7 @@ function buildEmbeddedPlansPath(params = {}) {
     }
     return `/?${query.toString()}`;
 }
-export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessionResolved, currentTheme = 'dark', projectName, currentWorkspaceId, apiBaseUrl, connectedEnvironmentSource, resolveCloudAuthUrl, embedded = false, shellOwnsScroll = false }) {
+export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessionResolved, currentTheme = 'dark', projectName, currentWorkspaceId, apiBaseUrl, connectedEnvironmentSource, resolveCloudAuthUrl, embedded = false, shellOwnsScroll = false, onAccountProfileSummaryChange, onContinueToTaskforce, continueBusy = false }) {
     const navigate = useNavigate();
     const location = useLocation();
     const [accountProfileSummary, setAccountProfileSummary] = useState(null);
@@ -148,13 +148,14 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
                 force: options?.force === true
             });
             setAccountProfileSummary(payload);
+            onAccountProfileSummaryChange?.(payload);
             return payload;
         }
         catch {
             // best effort only
             return null;
         }
-    }, [authUserId, buildCloudBillingUrl, isAuthenticated]);
+    }, [authUserId, buildCloudBillingUrl, isAuthenticated, onAccountProfileSummaryChange]);
     const resolveRecoveryMessage = useCallback((summary, fallback) => {
         const billingConflictCode = String(summary?.billingConflictCode || '').trim().toUpperCase();
         if (billingConflictCode === 'CHECKOUT_SESSION_EXPIRED')
@@ -166,11 +167,20 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
             return summaryMessage;
         return String(fallback || 'Unable to confirm checkout completion.').trim() || 'Unable to confirm checkout completion.';
     }, []);
+    const resolveGateFeedbackType = useCallback((message) => {
+        const normalized = String(message || '').trim();
+        if (normalized === GATE_MESSAGES.planSelectionRequired
+            || normalized === GATE_MESSAGES.checkoutPending) {
+            return 'info';
+        }
+        return 'error';
+    }, []);
     const startCheckout = useCallback(async (planVersionId, interval) => {
         if (!planVersionId) {
             setFeedback({ type: 'error', message: 'Selected plan is missing a default plan version.' });
             return;
         }
+        const hadActiveEntitlement = hasResolvedActiveEntitlement;
         setActionBusy(true);
         setFeedback(null);
         try {
@@ -189,13 +199,21 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
             if (checkoutState === 'free') {
                 setFeedback({ type: 'success', message: 'Plan selected. Your access is ready.' });
                 invalidateAccountProfileSummaryCache(buildCloudBillingUrl(ACCOUNT_PROFILE_SUMMARY_PATH), { identityKey: authUserId });
-                await loadAccountProfileSummary();
+                const summary = await loadAccountProfileSummary({ force: true });
+                const summaryState = String(summary?.entitlementState || '').trim().toLowerCase();
+                if (!hadActiveEntitlement && ACTIVE_ENTITLEMENT_STATES.has(summaryState)) {
+                    await onContinueToTaskforce?.();
+                }
                 return;
             }
             if (checkoutState === 'updated') {
                 setFeedback({ type: 'success', message: String(payload?.message || 'Your subscription was updated successfully.') });
                 invalidateAccountProfileSummaryCache(buildCloudBillingUrl(ACCOUNT_PROFILE_SUMMARY_PATH), { identityKey: authUserId });
-                await loadAccountProfileSummary();
+                const summary = await loadAccountProfileSummary({ force: true });
+                const summaryState = String(summary?.entitlementState || '').trim().toLowerCase();
+                if (!hadActiveEntitlement && ACTIVE_ENTITLEMENT_STATES.has(summaryState)) {
+                    await onContinueToTaskforce?.();
+                }
                 return;
             }
             if (checkoutState === 'already_current_plan') {
@@ -235,7 +253,7 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
         finally {
             setActionBusy(false);
         }
-    }, [authUserId, buildCloudBillingUrl, loadAccountProfileSummary, runtimeMode]);
+    }, [authUserId, buildCloudBillingUrl, hasResolvedActiveEntitlement, loadAccountProfileSummary, onContinueToTaskforce, runtimeMode]);
     const confirmCheckoutSession = useCallback(async (sessionId) => {
         if (!sessionId) {
             return {
@@ -258,7 +276,11 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
                 };
             }
             invalidateAccountProfileSummaryCache(buildCloudBillingUrl(ACCOUNT_PROFILE_SUMMARY_PATH), { identityKey: authUserId });
-            await loadAccountProfileSummary();
+            const summary = await loadAccountProfileSummary({ force: true });
+            const summaryState = String(summary?.entitlementState || '').trim().toLowerCase();
+            if (ACTIVE_ENTITLEMENT_STATES.has(summaryState)) {
+                await onContinueToTaskforce?.();
+            }
             return { confirmed: true };
         }
         catch {
@@ -267,7 +289,7 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
                 errorMessage: 'Unable to confirm checkout completion.'
             };
         }
-    }, [authUserId, buildCloudBillingUrl, loadAccountProfileSummary]);
+    }, [authUserId, buildCloudBillingUrl, loadAccountProfileSummary, onContinueToTaskforce]);
     const openBillingPortal = useCallback(async () => {
         if (!isAuthenticated) {
             navigate(`/login?mode=login&next=${encodeURIComponent(buildEmbeddedPlansPath())}`);
@@ -353,7 +375,7 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
             return;
         }
         if (gateMessage) {
-            setFeedback({ type: 'error', message: gateMessage });
+            setFeedback({ type: resolveGateFeedbackType(gateMessage), message: gateMessage });
             return;
         }
         setFeedback((current) => {
@@ -371,7 +393,7 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
                 return null;
             return current;
         });
-    }, [checkoutState, confirmCheckoutSession, gateMessage, isAuthenticated, loadAccountProfileSummary, queryInterval, queryPlanVersionId, querySessionId, resolveRecoveryMessage, scheduleTransientQueryClear, startCheckout]);
+    }, [checkoutState, confirmCheckoutSession, gateMessage, isAuthenticated, loadAccountProfileSummary, queryInterval, queryPlanVersionId, querySessionId, resolveGateFeedbackType, resolveRecoveryMessage, scheduleTransientQueryClear, startCheckout]);
     const handleSelectPlan = useCallback(async (intent) => {
         if (!isAuthenticated) {
             const nextCheckoutState = intent.pricingType === 'free' ? 'free' : 'start';
@@ -399,6 +421,10 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
         await startCheckout(intent.planVersionId, intent.interval);
     }, [isAuthenticated, navigate, openBillingPortal, startCheckout]);
     const handleBack = useCallback(() => {
+        if (hasResolvedActiveEntitlement && onContinueToTaskforce) {
+            void onContinueToTaskforce();
+            return;
+        }
         if (embedded) {
             closeEmbeddedPlansScreen();
             return;
@@ -408,8 +434,9 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
             return;
         }
         navigate('/');
-    }, [closeEmbeddedPlansScreen, embedded, navigate]);
-    const topActions = embedded ? (_jsx(_Fragment, { children: isAuthenticated && accountProfileSummary?.stripeCustomerId && (_jsx("button", { className: styles.navAction, onClick: () => { void openBillingPortal(); }, disabled: actionBusy, children: "Manage billing" })) })) : (_jsxs(_Fragment, { children: [_jsx("button", { className: styles.navAction, onClick: handleBack, children: "Back" }), isAuthenticated && accountProfileSummary?.stripeCustomerId && (_jsx("button", { className: styles.navAction, onClick: () => { void openBillingPortal(); }, disabled: actionBusy, children: "Manage billing" })), !isAuthenticated && (_jsxs("button", { className: styles.navAction, onClick: () => navigate(`/login?mode=login&next=${encodeURIComponent(buildEmbeddedPlansPath())}`), children: [_jsx(User, { size: 16, style: { marginRight: '8px', verticalAlign: 'text-bottom' } }), "Sign In"] }))] }));
+    }, [closeEmbeddedPlansScreen, embedded, hasResolvedActiveEntitlement, navigate, onContinueToTaskforce]);
+    const continueAction = hasResolvedActiveEntitlement && onContinueToTaskforce ? (_jsx("button", { className: styles.navAction, onClick: () => { void onContinueToTaskforce(); }, disabled: continueBusy || actionBusy, children: "Take Me to Taskforce" })) : null;
+    const topActions = embedded ? (_jsxs(_Fragment, { children: [continueAction, isAuthenticated && accountProfileSummary?.stripeCustomerId && (_jsx("button", { className: styles.navAction, onClick: () => { void openBillingPortal(); }, disabled: actionBusy, children: "Manage billing" }))] })) : (_jsxs(_Fragment, { children: [_jsx("button", { className: styles.navAction, onClick: handleBack, disabled: continueBusy || (isAuthenticated && !hasResolvedActiveEntitlement), children: hasResolvedActiveEntitlement ? 'Take Me to Taskforce' : 'Back' }), isAuthenticated && accountProfileSummary?.stripeCustomerId && (_jsx("button", { className: styles.navAction, onClick: () => { void openBillingPortal(); }, disabled: actionBusy, children: "Manage billing" })), !isAuthenticated && (_jsxs("button", { className: styles.navAction, onClick: () => navigate(`/login?mode=login&next=${encodeURIComponent(buildEmbeddedPlansPath())}`), children: [_jsx(User, { size: 16, style: { marginRight: '8px', verticalAlign: 'text-bottom' } }), "Sign In"] }))] }));
     const chrome = embedded ? null : (_jsx(AppShellHeader, { projectName: projectName, currentWorkspaceId: currentWorkspaceId, runtimeMode: runtimeMode === 'cloud' ? 'cloud' : 'local', theme: currentTheme, actions: topActions }));
-    return (_jsx(PlanComparisonPage, { chrome: chrome, heading: "Subscription Plans", subtitle: "Manage your subscription and explore available features. Your current plan is highlighted below.", isAuthenticated: isAuthenticated, authSessionResolved: authSessionResolved, currentPlanId: String(accountProfileSummary?.planId || queryPlanId || '').trim() || null, currentPlanVersionId: String(accountProfileSummary?.planVersionId || queryPlanVersionId || '').trim() || null, currentEntitlementState: String(accountProfileSummary?.entitlementState || '').trim() || null, canManageCurrentPlan: Boolean(accountProfileSummary?.stripeCustomerId), pricingEndpoint: pricingEndpoints[0], statusBanner: feedback, onBack: handleBack, backLabel: embedded ? 'Back to Board' : 'Back to App', topActions: embedded ? topActions : null, shellOwnsScroll: shellOwnsScroll, showPageBackButton: !embedded, fallbackPricingSource: fallbackPricingSource, onSelectPlan: handleSelectPlan }));
+    return (_jsx(PlanComparisonPage, { chrome: chrome, heading: "Subscription Plans", subtitle: "Manage your subscription and explore available features. Your current plan is highlighted below.", isAuthenticated: isAuthenticated, authSessionResolved: authSessionResolved, currentPlanId: String(accountProfileSummary?.planId || queryPlanId || '').trim() || null, currentPlanVersionId: String(accountProfileSummary?.planVersionId || queryPlanVersionId || '').trim() || null, currentEntitlementState: String(accountProfileSummary?.entitlementState || '').trim() || null, canManageCurrentPlan: Boolean(accountProfileSummary?.stripeCustomerId), pricingEndpoint: pricingEndpoints[0], statusBanner: feedback, onBack: handleBack, backLabel: hasResolvedActiveEntitlement ? 'Take Me to Taskforce' : (embedded ? 'Back to Board' : 'Back to App'), backDisabled: continueBusy || (isAuthenticated && !hasResolvedActiveEntitlement), topActions: embedded ? topActions : null, shellOwnsScroll: shellOwnsScroll, showPageBackButton: !embedded, fallbackPricingSource: fallbackPricingSource, onSelectPlan: handleSelectPlan }));
 }

package/dist/components/views/PlansPage.test.js

@@ -1,10 +1,16 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { render, screen, waitFor } from '@testing-library/react';
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
 import { afterEach, describe, expect, it, vi } from 'vitest';
 import { MemoryRouter } from 'react-router-dom';
 import { PlansPage } from './PlansPage';
 vi.mock('./PlanComparisonPage', () => ({
-    PlanComparisonPage: ({ heading, statusBanner }) => (_jsxs("div", { children: [_jsx("h1", { children: heading }), statusBanner?.message ? _jsx("div", { children: statusBanner.message }) : null] }))
+    PlanComparisonPage: ({ heading, statusBanner, topActions, onSelectPlan, onBack, backLabel, backDisabled }) => (_jsxs("div", { children: [_jsx("h1", { children: heading }), statusBanner?.message ? _jsx("div", { "data-status-type": statusBanner.type, children: statusBanner.message }) : null, topActions, onSelectPlan ? (_jsx("button", { onClick: () => onSelectPlan({
+                    planId: 'free',
+                    planVersionId: 'free-v1',
+                    interval: 'month',
+                    pricingType: 'free',
+                    isCurrentPlan: false
+                }), children: "Select Free Plan" })) : null, onBack ? (_jsx("button", { onClick: onBack, disabled: backDisabled, children: backLabel || 'Back' })) : null] }))
 }));
 describe('PlansPage', () => {
     afterEach(() => {
@@ -97,4 +103,55 @@ describe('PlansPage', () => {
         render(_jsx(MemoryRouter, { initialEntries: ['/?screen=plans&checkout=cancel'], children: _jsx(PlansPage, { isAuthenticated: true, authUserId: "u3", runtimeMode: "cloud", authSessionResolved: true, resolveCloudAuthUrl: (path) => path }) }));
         expect(await screen.findByText('Your previous checkout expired. Choose a plan to continue.')).toBeInTheDocument();
     });
+    it('auto-continues after a free plan grant and exposes a taskforce CTA once access is active', async () => {
+        const onContinueToTaskforce = vi.fn();
+        const fetchMock = vi.fn()
+            .mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                entitlementState: 'pending_plan_selection',
+                gate: 'plan_selection_required',
+                message: 'Choose a plan to continue.'
+            })
+        })
+            .mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                checkoutState: 'free'
+            })
+        })
+            .mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                entitlementState: 'active',
+                planId: 'free',
+                planVersionId: 'free-v1',
+                gate: 'ok',
+                message: null
+            })
+        });
+        vi.stubGlobal('fetch', fetchMock);
+        render(_jsx(MemoryRouter, { initialEntries: ['/?screen=plans&gate=plan_selection_required'], children: _jsx(PlansPage, { isAuthenticated: true, authUserId: "u4", runtimeMode: "cloud", authSessionResolved: true, resolveCloudAuthUrl: (path) => path, onContinueToTaskforce: onContinueToTaskforce }) }));
+        expect(await screen.findByText('Choose a plan to continue.')).toBeInTheDocument();
+        fireEvent.click(screen.getByRole('button', { name: 'Select Free Plan' }));
+        await waitFor(() => {
+            expect(onContinueToTaskforce).toHaveBeenCalledTimes(1);
+        });
+        expect(screen.getByRole('button', { name: 'Take Me to Taskforce' })).toBeInTheDocument();
+    });
+    it('disables the back action while the account is still entitlement-blocked', async () => {
+        const fetchMock = vi.fn()
+            .mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                entitlementState: 'pending_plan_selection',
+                gate: 'plan_selection_required',
+                message: 'Choose a plan to continue.'
+            })
+        });
+        vi.stubGlobal('fetch', fetchMock);
+        render(_jsx(MemoryRouter, { initialEntries: ['/?screen=plans&gate=plan_selection_required'], children: _jsx(PlansPage, { isAuthenticated: true, authUserId: "u5", runtimeMode: "cloud", authSessionResolved: true, resolveCloudAuthUrl: (path) => path }) }));
+        expect(await screen.findByRole('button', { name: 'Back to App' })).toBeDisabled();
+        expect(screen.getByText('Choose a plan to continue.')).toHaveAttribute('data-status-type', 'info');
+    });
 });