@taskforcehq/taskforce 0.3.308 → 0.3.311

package/README.md

@@ -1,182 +1,106 @@
 # Taskforce
 
-Taskforce is a task management system for humans working with AI.
+Taskforce is a shared task and planning workspace for humans collaborating with AI.
 
-It combines structured task tracking, planning layers, document and image review workflows, and built-in MCP access so AI collaborators can participate in the same operational system instead of living in a separate chat transcript.
+It brings tasks, planning, document review, image review, and AI access into one place so people and AI collaborators can work from the same source of truth.
 
 Taskforce is currently in beta and under active development.
 
-## What Taskforce includes today
+## Install Taskforce
 
-### Core task management
-- Tasks with title, description, status, priority, type, category, assignee, due date, scheduled date, and checklist support
-- Custom workspace taxonomy for categories, types, priorities, approaches, and complexity
-- Task comments and task attachments
-- Schedule board for planning work by day
-- Archive and restore flows for completed or cancelled work
-
-### Planning model
-- Initiatives, workstreams, tasks, and checklists
-- Workstream and initiative assignment for tasks
-- Initiative templates for reusable planning structures such as launch, migration, or incident work
-
-### AI collaboration
-- Built-in MCP support for local and cloud usage
-- AI profile resolution and task ownership for agent collaborators
-- MCP tools for reading and updating tasks, planning entities, documents, image reviews, schedules, and attachments
-- Local MCP configuration for local clients such as Codex, Claude Code CLI, and Gemini CLI
-- Cloud MCP token flow for remote clients
+Install Taskforce once, then run it from any workspace:
 
-### Document and image review
-- Canonical document assets with document review sessions and threaded review comments
-- Image Notes for visual review with saved annotation sessions and markers
-- MCP helper flows for document review and image review
-
-### Runtime and deployment model
-- Local runtime and cloud runtime support
-- Separate app, site, and admin surfaces in the repo
-- Auth, billing, and account flows for the hosted product
-- Workspace sync and cloud/local runtime routing infrastructure
-
-## What is intentionally not part of the product right now
-
-These exist in the codebase in some form, but should not be treated as current product surface area.
-
-- **Workflow editor**: currently disabled and should not be presented as an active feature
-- **Embedded widget/in-app overlay version**: not part of the product right now, not tested recently, and likely to be deprecated
-
-## Product surfaces
-
-- `apps/app` - the main Taskforce application
-- `apps/site` - the public website / marketing surface
-- `apps/admin` - the admin surface
-
-## Repository structure
-
-```text
-apps/
-  app/          Main product app
-  site/         Public website
-  admin/        Admin surface
-src/
-  components/   UI components and product modules
-  core/         Core application logic
-  server/       Server routes and runtime logic
-  mcp/          MCP runtime and tool registry
-  sync/         Sync model and transfer logic
-  storage/      Persistence and asset storage
-tests/
-  e2e/          Playwright realtime and interactive browser scenarios
-  soak/         Playwright soak and endurance scenarios
+```bash
+npm install --global @taskforcehq/taskforce
 ```
 
-Most fast regression coverage is colocated beside the code under `src/` and `apps/` as `*.test.ts` and `*.test.tsx` files.
-
-## Getting started
-
-### Prerequisites
-- Node.js 20+
-- npm
-
-### Install dependencies
+Then open Taskforce from the workspace you want to manage:
 
 ```bash
-npm ci
+taskforce open
 ```
 
-### Run the main app locally
+You can also install with Homebrew:
 
 ```bash
-npm run dev
+brew tap taskforcehq/tap
+brew install taskforce
 ```
 
-If you need the runtime-oriented local flow used by the product rather than simple frontend dev mode, use the repo scripts documented in `package.json` and the active docs under `docs/reference/` and `docs/runbooks/`.
+The npm package page may show `npm i @taskforcehq/taskforce`, but most users should include `--global` so the `taskforce` command is available from the terminal.
 
-### Build
+## Get Started
+
+Go to the folder you want Taskforce to manage, then run:
 
 ```bash
-npm run build
+taskforce open
 ```
 
-## MCP
-
-Taskforce includes built-in MCP support so AI clients can operate directly against the workspace.
+Taskforce opens in your browser and stores workspace data in that folder, under `.taskforce/`.
 
-### Local MCP
-Use Local MCP for local stdio-based clients. This is the intended path for tools such as:
-- Codex
-- Claude Code CLI
-- Gemini CLI
+To confirm which workspace Taskforce is using:
 
-Local MCP does not require a cloud token.
+```bash
+taskforce status
+```
 
-### Cloud MCP
-Use Cloud MCP for hosted remote clients. Cloud MCP uses token-based access and the hosted MCP endpoint.
+To connect a local AI client through MCP, start the MCP server from the same workspace:
 
-## Major product capabilities
+```bash
+taskforce mcp
+```
 
-### 1. Shared task system for humans and AI
-Taskforce is designed so people and AI agents can work from the same task graph, rather than forcing humans to maintain one system and agents to operate from another.
+## What Taskforce Includes
 
-### 2. Planning beyond flat tasks
-Taskforce supports a planning hierarchy that can represent real work:
-- Initiative
-- Workstream
-- Task
-- Checklist
+### Task Management
 
-This is meant to support launch work, migrations, larger feature tracks, and other multi-layer efforts.
+- Tasks with title, description, status, priority, type, category, assignee, due date, scheduled date, and checklist support
+- Custom workspace taxonomy for categories, types, priorities, approaches, and complexity
+- Task comments and task attachments
+- Schedule board for planning work by day
+- Archive and restore flows for completed or cancelled work
 
-### 3. Review-native workflows
-Taskforce includes first-class review surfaces for:
-- documents, via document review sessions and comments
-- images, via Image Notes sessions and markers
+### Planning
 
-These are not decorative attachments. They are structured review workflows.
+- Initiatives, workstreams, tasks, and checklists
+- Workstream and initiative assignment for tasks
+- Initiative templates for reusable planning structures such as launches, migrations, and incident response
 
-### 4. AI-operable product state
-Taskforce exposes product state through MCP so agents can:
-- read tasks and planning structures
-- update status and ownership
-- create and comment on review sessions
-- work with schedules and attachments
+### AI Collaboration
 
-## What to avoid saying about Taskforce right now
+- Built-in MCP access for AI clients
+- AI profiles and task ownership for agent collaborators
+- Tools for agents to read and update tasks, planning entities, documents, image reviews, schedules, and attachments
+- Local MCP support for clients such as Codex, Claude Code CLI, and Gemini CLI
+- Cloud MCP access for hosted remote clients
 
-Do not describe Taskforce as:
-- a production-ready embedded widget product
-- a workflow editor product
-- a generic developer overlay tool
-- something centered only on AI-developer pairs
+### Document And Image Review
 
-That undersells or misstates where the product is now.
+- Document review sessions with threaded comments
+- Image Notes for visual review with saved annotation sessions and markers
+- AI-assisted document and image review workflows
 
-A better framing is:
+### Sync And Hosted Workspaces
 
-> Taskforce is a task and planning system for humans collaborating with AI, with built-in review workflows and MCP access.
+- Local workspace data for private, machine-local use
+- Hosted workspaces for cloud-backed collaboration
+- Workspace sync between local and cloud environments
+- Account, auth, and billing flows for hosted usage
 
-## Development notes
+## MCP
 
-### Validation
-Useful local checks include:
+Taskforce includes built-in MCP support so AI clients can work directly with your workspace.
 
-```bash
-npm run build
-npm run test
-```
+Local MCP is for AI clients running on the same machine as your workspace. It does not require a cloud token.
 
-Testing guidance lives in:
+Cloud MCP is for hosted remote clients and uses token-based access.
 
-- `docs/reference/engineering/test-infrastructure.md`
-- `docs/runbooks/sync-soak-runbook.md`
-- `docs/reference/operations/external-qa-workflow.md`
+## Requirements
 
-### Important docs
-- `docs/reference/engineering/test-infrastructure.md`
-- `docs/reference/platform/runtime-modes-contract.md`
-- `docs/reference/operations/external-qa-workflow.md`
-- `docs/runbooks/sync-soak-runbook.md`
+- Node.js 20+
+- npm, or Homebrew on macOS
 
 ## Status
 
-Taskforce is in active beta development. The product surface is moving, so this README is intentionally conservative and only describes capabilities that are complete enough to stand behind today.
+Taskforce is in active beta development. This README describes the user-facing capabilities that are ready to try today.

package/dist/components/context/ContextAttachmentManager.js

@@ -1,7 +1,8 @@
-import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useEffect, useMemo, useRef, useState } from 'react';
-import { AlertTriangle, Copy, Download, File, FileUp, Loader2, PencilLine, Trash2, ChevronDown, ChevronRight } from 'lucide-react';
+import { AlertTriangle, Copy, Download, File, FileUp, Loader2, PencilLine, Trash2 } from 'lucide-react';
 import styles from '../../Taskforce.module.css';
+import { DisclosureSectionHeader } from '../ui/DisclosureSectionHeader';
 import { dispatchOpenMarkdownDocument } from '../../utils/contextFiles';
 import { canOpenAnnotatedAttachment, dispatchOpenAnnotatedAttachment } from '../../utils/annotatedAttachments';
 import { dispatchTaskforceContextAssetsMutated } from '../../utils/contextAssetEvents';
@@ -460,7 +461,7 @@ export function ContextAttachmentManager(props) {
         const path = typeof item === 'string' ? item : item.path;
         return !isImagePath(path);
     });
-    return (_jsxs("div", { className: styles.specialistSection, children: [_jsxs("div", { className: styles.toggleHeading, onClick: () => setShowContextUpload(!showContextUpload), title: showContextUpload ? 'Hide context documents' : 'Show context documents', children: [_jsxs("label", { className: styles.label, children: ["Context Documents ", attachments.length > 0 && `(${attachments.length})`] }), showContextUpload ? _jsx(ChevronDown, { size: 14 }) : _jsx(ChevronRight, { size: 14 })] }), showContextUpload && (_jsxs(_Fragment, { children: [_jsxs("p", { className: styles.settingsHint, children: ["Upload files into ", ownerTypeLabel, " context storage, or add an external http(s) URL."] }), _jsxs("div", { className: styles.contextUploadPanel, children: [_jsxs("div", { className: styles.contextUploadActions, children: [_jsxs("button", { type: "button", className: styles.secondaryHeaderBtn, onClick: () => inputRef.current?.click(), disabled: uploading, children: [uploading ? _jsx(Loader2, { size: 12, className: styles.spinner }) : _jsx(FileUp, { size: 12 }), uploading ? 'Uploading...' : 'Upload File'] }), _jsxs("button", { type: "button", className: styles.secondaryHeaderBtn, onClick: () => {
+    return (_jsxs("div", { className: styles.specialistSection, children: [_jsx(DisclosureSectionHeader, { label: "Context Documents", count: attachments.length, expanded: showContextUpload, expandedTitle: "Hide context documents", collapsedTitle: "Show context documents", onToggle: () => setShowContextUpload(!showContextUpload) }), showContextUpload && (_jsxs(_Fragment, { children: [_jsxs("p", { className: styles.settingsHint, children: ["Upload files into ", ownerTypeLabel, " context storage, or add an external http(s) URL."] }), _jsxs("div", { className: styles.contextUploadPanel, children: [_jsxs("div", { className: styles.contextUploadActions, children: [_jsxs("button", { type: "button", className: styles.secondaryHeaderBtn, onClick: () => inputRef.current?.click(), disabled: uploading, children: [uploading ? _jsx(Loader2, { size: 12, className: styles.spinner }) : _jsx(FileUp, { size: 12 }), uploading ? 'Uploading...' : 'Upload File'] }), _jsxs("button", { type: "button", className: styles.secondaryHeaderBtn, onClick: () => {
                                             void handlePasteImage();
                                         }, disabled: uploading, children: [_jsx(Copy, { size: 12 }), "Paste Image from Clipboard"] })] }), _jsx("input", { ref: inputRef, type: "file", accept: ACCEPTED_CONTEXT_FILE_TYPES, multiple: true, className: styles.hiddenInput, onChange: (e) => {
                                     void handleFilesSelected(e.target.files);

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

@@ -0,0 +1,12 @@
+interface DisclosureSectionHeaderProps {
+    label: string;
+    count?: number;
+    showZeroCount?: boolean;
+    expanded: boolean;
+    expandedTitle: string;
+    collapsedTitle: string;
+    onToggle: () => void;
+    className?: string;
+}
+export declare function DisclosureSectionHeader({ label, count, showZeroCount, expanded, expandedTitle, collapsedTitle, onToggle, className, }: DisclosureSectionHeaderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/ui/DisclosureSectionHeader.js

@@ -0,0 +1,8 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { ChevronDown, ChevronRight } from 'lucide-react';
+import styles from './DisclosureSectionHeader.module.css';
+export function DisclosureSectionHeader({ label, count, showZeroCount = false, expanded, expandedTitle, collapsedTitle, onToggle, className = '', }) {
+    const shouldShowCount = typeof count === 'number' && (showZeroCount || count > 0);
+    const Icon = expanded ? ChevronDown : ChevronRight;
+    return (_jsxs("button", { type: "button", className: `${styles.header} ${className}`.trim(), onClick: onToggle, "aria-expanded": expanded, title: expanded ? expandedTitle : collapsedTitle, children: [_jsxs("span", { className: styles.title, children: [label, shouldShowCount ? ` (${count})` : ''] }), _jsx(Icon, { className: styles.icon, size: 14, "aria-hidden": "true" })] }));
+}

package/dist/components/views/PlanComparisonPage.js

@@ -386,5 +386,5 @@ export function PlanComparisonPage({ heading, subtitle, variant = 'app', theme =
                                                                 isCurrentPlan: false
                                                             });
                                                         }, disabled: !planVersionId || !planSelectionEnabled, children: hasMultipleBillingOptions ? 'Start Yearly' : 'Get Started' })) : null] }))] }, plan.planId));
-                                }) }), _jsxs("div", { className: styles.pricingNotes, children: [_jsx("p", { children: "Prices are listed in USD. Taxes may apply." }), _jsx("p", { children: "Local install is free on every plan. Cloud limits apply only to hosted workspaces." })] }), _jsxs("section", { className: `${styles.foundingBeta} ${styles.cloudCapacityNote}`, "aria-labelledby": "cloud-capacity-heading", children: [_jsx("h2", { id: "cloud-capacity-heading", children: "Need more cloud capacity?" }), _jsx("p", { children: "Pro users can request expanded limits for cloud workspaces, AI agents, and storage." })] }), _jsxs("div", { className: `${styles.planCard} ${styles.planNoticeCard} ${styles.teamComingSoonCard}`, children: [_jsx("h2", { className: styles.planName, children: "Team workspaces are coming soon." }), _jsx("p", { className: styles.planDescription, children: "Shared workspaces, collaborators, team agent rosters, admin controls, and larger cloud limits are in development." })] })] }))] }) }) }));
+                                }) }), _jsxs("div", { className: styles.pricingNotes, children: [_jsx("p", { children: "Prices are listed in USD. Taxes may apply." }), _jsx("p", { children: "Local install is free on every plan. Cloud limits apply only to hosted workspaces." })] }), _jsxs("section", { className: `${styles.foundingBeta} ${styles.cloudCapacityNote}`, "aria-labelledby": "cloud-capacity-heading", children: [_jsx("h2", { id: "cloud-capacity-heading", children: "Need more cloud capacity?" }), _jsx("p", { children: "Pro users can request expanded limits for cloud workspaces, AI agents, and storage." }), _jsxs("p", { children: ["Contact ", _jsx("a", { href: "mailto:support@taskforcehq.ai", children: "support@taskforcehq.ai" }), " to discuss capacity needs."] })] }), _jsxs("div", { className: `${styles.planCard} ${styles.planNoticeCard} ${styles.teamComingSoonCard}`, children: [_jsx("h2", { className: styles.planName, children: "Team workspaces are coming soon." }), _jsx("p", { className: styles.planDescription, children: "Shared workspaces, collaborators, team agent rosters, admin controls, and larger cloud limits are in development." })] })] }))] }) }) }));
 }

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

@@ -72,6 +72,7 @@ describe('PlanComparisonPage', () => {
         expect(screen.getByText(/Early members get access while the product is still forming/)).toBeInTheDocument();
         expect(screen.getByText('Prices are listed in USD. Taxes may apply.')).toBeInTheDocument();
         expect(screen.getByText('Local install is free on every plan. Cloud limits apply only to hosted workspaces.')).toBeInTheDocument();
+        expect(screen.getByRole('link', { name: 'support@taskforcehq.ai' })).toHaveAttribute('href', 'mailto:support@taskforcehq.ai');
         const foundingBeta = screen.getByRole('heading', { name: 'Founding beta' }).closest('section');
         const firstPlanCard = container.querySelector('[data-testid^="plan-card-"]');
         const planCards = container.querySelectorAll('[data-testid^="plan-card-"]');

package/dist/components/views/StandaloneLayout.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import React, { useMemo, useCallback, useState, useEffect, useRef, Suspense } from 'react';
 import { createPortal } from 'react-dom';
 import { useLocation, useNavigate } from 'react-router-dom';
-import { Settings, Plus, Filter, Layers, User, Maximize2, Minimize2, Check, ChevronLeft, ArrowUp, ArrowDown, ArrowUpDown, AlertTriangle, Save, Loader2, Folder, FileText, LogOut, NotebookTabs, ClipboardCheck, Cloud, CloudOff, Users, ClockAlert, ChevronsUp, ChevronsDown, EyeOff, Zap, HelpCircle, Bot, Image, Workflow, Plug } from 'lucide-react';
+import { Settings, Plus, Filter, Layers, User, Maximize2, Minimize2, Check, ChevronLeft, ArrowUp, ArrowDown, ArrowUpDown, AlertTriangle, Save, Loader2, Folder, FileText, LogOut, NotebookTabs, ClipboardCheck, Cloud, CloudOff, Users, ClockAlert, Mail, ChevronsUp, ChevronsDown, EyeOff, Zap, HelpCircle, Bot, Image, Workflow, Plug } from 'lucide-react';
 import { STATUS_OPTIONS, getStatusDefinition } from '../../utils/constants';
 import styles from '../../Taskforce.module.css';
 import shellStyles from './WorkspaceShell.module.css';
@@ -41,6 +41,7 @@ import { resolveAnnotatedAttachmentDetail } from '../../utils/annotatedAttachmen
 import { ACCOUNT_PROFILE_SUMMARY_PATH, invalidateAccountProfileSummaryCache, loadAccountProfileSummaryCached } from '../../utils/accountProfileSummaryCache';
 import { prepareAvatarUploadFile } from '../../utils/avatarUpload';
 import { resolveCommercialLifecyclePresentation } from '../../utils/commercialLifecyclePresentation';
+import { buildSupportMailtoHref } from '../../utils/supportContact';
 import { AppShellHeader } from './AppShellHeader';
 import { getTaskforceCloudEnvironmentConfig, parseTaskforceCloudEnvironment, resolveTaskforceCloudEnvironmentFromBaseUrl } from '../../config/cloudEnvironment';
 import { logBootstrapDebug, persistRemoteUiState } from '../../hooks/workspace/workspaceLocalState';
@@ -1382,6 +1383,15 @@ export function StandaloneLayout(props) {
     const authIdentityLabel = authDisplayName || authEmailLabel;
     const hasAuthIdentity = authIdentityLabel.length > 0;
     const hasAuthEmail = authEmailLabel.length > 0;
+    const supportMailtoHref = useMemo(() => buildSupportMailtoHref({
+        workspaceName: currentWorkspaceLabel,
+        workspaceId: currentWorkspaceId,
+        accountLabel: authIdentityLabel || authEmailLabel,
+        runtimeMode
+    }), [authEmailLabel, authIdentityLabel, currentWorkspaceId, currentWorkspaceLabel, runtimeMode]);
+    const openSupportEmail = useCallback(() => {
+        window.location.href = supportMailtoHref;
+    }, [supportMailtoHref]);
     const accountBadgeLabel = (authIdentityLabel || authEmailLabel || '').trim();
     const shouldShowResolvedAccountInitial = isAuthenticated && authSessionResolved && accountBadgeLabel.length > 0;
     const accountBadgeInitial = shouldShowResolvedAccountInitial ? accountBadgeLabel.charAt(0).toUpperCase() : '';
@@ -2428,7 +2438,10 @@ export function StandaloneLayout(props) {
                         }, role: "menuitem", children: [_jsx(User, { size: 15 }), "Account Hub"] }), _jsxs("button", { className: accountStyles.accountMenuItem, onClick: () => {
                             setShowAccountMenu(false);
                             setShowHelpModal(true);
-                        }, role: "menuitem", children: [_jsx(HelpCircle, { size: 15 }), "Help & Tutorial"] }), runtimeMode === 'local' && !isAuthenticated && !isAuthBootstrapPending && (_jsxs("button", { className: accountStyles.accountMenuItem, onClick: () => {
+                        }, role: "menuitem", children: [_jsx(HelpCircle, { size: 15 }), "Help & Support"] }), _jsxs("button", { className: accountStyles.accountMenuItem, onClick: () => {
+                            setShowAccountMenu(false);
+                            openSupportEmail();
+                        }, role: "menuitem", children: [_jsx(Mail, { size: 15 }), "Contact Support"] }), runtimeMode === 'local' && !isAuthenticated && !isAuthBootstrapPending && (_jsxs("button", { className: accountStyles.accountMenuItem, onClick: () => {
                             openSharedLoginRoute('login');
                         }, role: "menuitem", children: [_jsx(User, { size: 15 }), "Sign In / Register"] })), isAuthenticated && (_jsxs("button", { className: accountStyles.accountMenuItem, onClick: async () => {
                             setShowAccountMenu(false);
@@ -3315,15 +3328,19 @@ export function StandaloneLayout(props) {
                         }, currentTask: currentTask })] }), _jsx(Modal, { isOpen: activeTab === 'settings', onClose: handleCloseModal, title: "Settings", size: "xl", theme: currentTheme, draggable: true, isSettings: true, closeOnOverlayClick: false, children: _jsx(Suspense, { fallback: _jsx("div", { style: { display: 'flex', alignItems: 'center', justifyContent: 'center', padding: '2rem' }, children: _jsx(Loader2, { size: 20, className: styles.spinner }) }), children: _jsx(TaskSettings, { settingsModel: {
                             ...settingsModel,
                             onOpenCloudAuth: openSharedLoginRoute
-                        }, onSectionChange: setSettingsSection }) }) }), _jsx(ScheduleWarningModal, { prompt: scheduleWarningPrompt, theme: currentTheme, onClose: cancelScheduleWarning, onConfirm: confirmScheduleWarning }), _jsx(SyncEnableWarningModal, { isOpen: showSyncEnableWarning, theme: currentTheme, onClose: cancelSyncEnableWarning, onConfirm: confirmSyncEnableWarning }), _jsx(HelpModal, { isOpen: showHelpModal, theme: currentTheme, onClose: () => setShowHelpModal(false), onOpenSettings: () => {
+                        }, onSectionChange: setSettingsSection }) }) }), _jsx(ScheduleWarningModal, { prompt: scheduleWarningPrompt, theme: currentTheme, onClose: cancelScheduleWarning, onConfirm: confirmScheduleWarning }), _jsx(SyncEnableWarningModal, { isOpen: showSyncEnableWarning, theme: currentTheme, onClose: cancelSyncEnableWarning, onConfirm: confirmSyncEnableWarning }), _jsx(HelpModal, { isOpen: showHelpModal, theme: currentTheme, onClose: () => setShowHelpModal(false), supportMailtoHref: supportMailtoHref, onOpenSettings: () => {
                     setShowHelpModal(false);
                     setActiveTab('settings');
                     setSettingsSection('general');
+                }, onOpenAccountHub: () => {
+                    setShowHelpModal(false);
+                    startAccountSurfaceTiming('account_hub');
+                    setShowAccountHub(true);
                 } }), _jsx(EditProfileModal, { isOpen: showEditProfileModal, theme: currentTheme, onClose: closeEditProfileModal, onSave: () => { void handleSaveProfile(); }, displayName: profileDisplayNameDraft, email: authEmailLabel, avatarDisplayUrl: profileAvatarDisplayUrl, accountBadgeInitial: accountBadgeInitial, saveBusy: profileSaveBusy, avatarBusy: profileAvatarBusy, saveError: profileSaveError, saveNotice: profileSaveNotice, onDisplayNameChange: setProfileDisplayNameDraft, onOpenAvatarManager: () => {
                     setProfileSaveError(null);
                     setProfileSaveNotice(null);
                     setShowAvatarPhotoManager(true);
-                } }), _jsx(AvatarImageManagerModal, { isOpen: showAvatarPhotoManager, theme: currentTheme, title: "Edit Profile Photo", currentImageUrl: profileAvatarDisplayUrl, fallbackInitial: accountBadgeInitial, accept: PROFILE_AVATAR_ACCEPT, busy: profileAvatarBusy, hasPendingImage: Boolean(profileAvatarDraftId), canRemove: Boolean(profileAvatarDisplayUrl), error: profileSaveError, notice: profileSaveNotice, onClose: () => setShowAvatarPhotoManager(false), onApplyImage: handleProfileAvatarSelected, onRemoveImage: handleRemoveProfileAvatar, onDiscardPendingImage: handleDiscardPendingProfileAvatar }), _jsx(AccountHubModal, { isOpen: showAccountHub, theme: currentTheme, runtimeMode: runtimeMode, authRequiredForApi: authRequiredForApi, isAuthenticated: isAuthenticated, hasAuthIdentity: hasAuthIdentity, authIdentityLabel: authIdentityLabel, billingLoading: billingLoading, billingError: billingError, billingActionError: billingActionError, billingNotice: billingNotice, billingActionBusy: billingActionBusy, billingIntervalChoice: billingIntervalChoice, accountProfileSummary: accountProfileSummary, currentWorkspaceId: currentWorkspaceId, canOpenTeamManagement: canOpenTeamManagement, canManageWorkspaceSync: canManageWorkspaceSync, workspaceCloudSyncEnabled: workspaceCloudSyncEnabled, syncStatusLabel: syncStatusMeta.label, workspaceSyncError: workspaceSyncError, syncControlBusy: syncControlBusy, cloudAuthEnabled: cloudAuthConfigured, availableAuthProviders: availableAuthProviders, onFetchLoginMethods: fetchLoginMethods, onUnlinkLoginMethod: unlinkLoginMethod, onAddPassword: addPasswordToAccount, onLinkProvider: (provider) => beginOAuthLink(provider), onClose: () => setShowAccountHub(false), onOpenWorkspaceAudit: () => {
+                } }), _jsx(AvatarImageManagerModal, { isOpen: showAvatarPhotoManager, theme: currentTheme, title: "Edit Profile Photo", currentImageUrl: profileAvatarDisplayUrl, fallbackInitial: accountBadgeInitial, accept: PROFILE_AVATAR_ACCEPT, busy: profileAvatarBusy, hasPendingImage: Boolean(profileAvatarDraftId), canRemove: Boolean(profileAvatarDisplayUrl), error: profileSaveError, notice: profileSaveNotice, onClose: () => setShowAvatarPhotoManager(false), onApplyImage: handleProfileAvatarSelected, onRemoveImage: handleRemoveProfileAvatar, onDiscardPendingImage: handleDiscardPendingProfileAvatar }), _jsx(AccountHubModal, { isOpen: showAccountHub, theme: currentTheme, runtimeMode: runtimeMode, authRequiredForApi: authRequiredForApi, isAuthenticated: isAuthenticated, hasAuthIdentity: hasAuthIdentity, authIdentityLabel: authIdentityLabel, billingLoading: billingLoading, billingError: billingError, billingActionError: billingActionError, billingNotice: billingNotice, billingActionBusy: billingActionBusy, billingIntervalChoice: billingIntervalChoice, accountProfileSummary: accountProfileSummary, currentWorkspaceId: currentWorkspaceId, canOpenTeamManagement: canOpenTeamManagement, canManageWorkspaceSync: canManageWorkspaceSync, workspaceCloudSyncEnabled: workspaceCloudSyncEnabled, syncStatusLabel: syncStatusMeta.label, workspaceSyncError: workspaceSyncError, syncControlBusy: syncControlBusy, supportMailtoHref: supportMailtoHref, cloudAuthEnabled: cloudAuthConfigured, availableAuthProviders: availableAuthProviders, onFetchLoginMethods: fetchLoginMethods, onUnlinkLoginMethod: unlinkLoginMethod, onAddPassword: addPasswordToAccount, onLinkProvider: (provider) => beginOAuthLink(provider), onClose: () => setShowAccountHub(false), onOpenWorkspaceAudit: () => {
                     setShowAccountHub(false);
                     void openTeamManagementModal();
                     setTeamManagementTab('audit');

package/dist/components/views/panels/PlanningDrawer.js

@@ -7,6 +7,7 @@ import styles from '../../../Taskforce.module.css';
 import panelStyles from './PlanningDrawer.module.css';
 import { ReferenceBadgeButton } from '../../ui/ReferenceBadgeButton';
 import { HierarchyActionBadge } from '../../ui/HierarchyActionBadge';
+import { DisclosureSectionHeader } from '../../ui/DisclosureSectionHeader';
 import { IconMap, getStatusDefinition, resolveColor } from '../../../utils/constants';
 import { formatInitiativeReference, formatWorkstreamReference, } from '../../../utils/planningReferences.js';
 import { getEntityActivityItems } from '../../../utils/taskActivity';
@@ -363,7 +364,7 @@ function PlanningDrawerDetailView({ detail, currentWorkspaceId, onOpenNestedWork
                                             event.preventDefault();
                                             handleOpenTask();
                                         }, children: [_jsx("span", { className: panelStyles.listItemTitle, children: task.title }), _jsx("span", { className: panelStyles.listItemMeta, children: taskMeta })] })] }) }, task.id));
-                    }) : (_jsxs("div", { className: panelStyles.sectionNote, children: ["No tasks are linked to this workstream yet. Use the ", _jsx("code", { children: "+" }), " action above to add the first one."] })))] }), _jsx("div", { className: panelStyles.listCard, children: _jsx(React.Suspense, { fallback: _jsx(DeferredPlanningPanelFallback, {}), children: _jsx(DeferredContextAttachmentManager, { ownerType: detail.type, ownerId: detail.item.id, ownerReferenceLabel: detailReferenceLabel, workspaceId: currentWorkspaceId, attachments: detail.item.attachments || [], onAddAttachment: (file) => onAddPlanningContextFile?.(detail.type, detail.item.id, file), onRemoveAttachment: (index) => onRemovePlanningContextFile?.(detail.type, detail.item.id, index), onUpdateAttachmentCaption: (index, caption) => (onUpdatePlanningContextCaption?.(detail.type, detail.item.id, index, caption)) }) }) }), _jsxs("div", { className: panelStyles.listCard, children: [_jsxs("button", { type: "button", className: panelStyles.sectionToggleButton, onClick: () => setShowRecentActivity((current) => !current), "aria-expanded": showRecentActivity, title: showRecentActivity ? 'Hide recent activity' : 'Show recent activity', children: [_jsxs("span", { className: panelStyles.sectionTitle, children: ["Recent activity (", activityCount, ")"] }), showRecentActivity ? _jsx(ChevronDown, { size: 14 }) : _jsx(ChevronRight, { size: 14 })] }), showRecentActivity ? (_jsx(React.Suspense, { fallback: _jsx(DeferredPlanningPanelFallback, {}), children: _jsx(DeferredEntityActivityTimeline, { activity: detail.item.activity, comments: detail.item.comments, formatFieldValue: formatActivityFieldValue, resolveActorPresentation: resolveActivityActorPresentation, onOpenTaskById: onOpenTaskById, emptyMessage: `No ${detail.type} activity yet.`, listClassName: panelStyles.activityTimelineList, emptyClassName: panelStyles.activityTimelineEmpty }) })) : null] })] }));
+                    }) : (_jsxs("div", { className: panelStyles.sectionNote, children: ["No tasks are linked to this workstream yet. Use the ", _jsx("code", { children: "+" }), " action above to add the first one."] })))] }), _jsx("div", { className: panelStyles.listCard, children: _jsx(React.Suspense, { fallback: _jsx(DeferredPlanningPanelFallback, {}), children: _jsx(DeferredContextAttachmentManager, { ownerType: detail.type, ownerId: detail.item.id, ownerReferenceLabel: detailReferenceLabel, workspaceId: currentWorkspaceId, attachments: detail.item.attachments || [], onAddAttachment: (file) => onAddPlanningContextFile?.(detail.type, detail.item.id, file), onRemoveAttachment: (index) => onRemovePlanningContextFile?.(detail.type, detail.item.id, index), onUpdateAttachmentCaption: (index, caption) => (onUpdatePlanningContextCaption?.(detail.type, detail.item.id, index, caption)) }) }) }), _jsxs("div", { className: panelStyles.listCard, children: [_jsx(DisclosureSectionHeader, { label: "Recent Activity", count: activityCount, showZeroCount: true, expanded: showRecentActivity, expandedTitle: "Hide recent activity", collapsedTitle: "Show recent activity", onToggle: () => setShowRecentActivity((current) => !current) }), showRecentActivity ? (_jsx(React.Suspense, { fallback: _jsx(DeferredPlanningPanelFallback, {}), children: _jsx(DeferredEntityActivityTimeline, { activity: detail.item.activity, comments: detail.item.comments, formatFieldValue: formatActivityFieldValue, resolveActorPresentation: resolveActivityActorPresentation, onOpenTaskById: onOpenTaskById, emptyMessage: `No ${detail.type} activity yet.`, listClassName: panelStyles.activityTimelineList, emptyClassName: panelStyles.activityTimelineEmpty }) })) : null] })] }));
 }
 function PlanningDrawerEditor({ editor, draftTitle, draftDescription, draftOwner, draftInitiativeId, assigneeOptions, draftInitiativeSummary, onChangeDraftTitle, onChangeDraftDescription, onChangeDraftOwner, onChangeDraftInitiativeId, onCancel, onSubmit, isSubmitting, onAssignInitiativeToWorkstream, }) {
     const entityLabel = editor.entityType === 'initiative' ? 'Initiative' : 'Workstream';

package/dist/components/views/panels/PlanningDrawer.test.js

@@ -490,10 +490,10 @@ describe('PlanningDrawer context attachments', () => {
             detail: { type: 'workstream', item: workstreamSummary },
         });
         const contextHeading = await screen.findByText('Context Documents (1)');
-        const activityHeading = screen.getByText('Recent activity (1)');
+        const activityHeading = screen.getByText('Recent Activity (1)');
         expect(Boolean(contextHeading.compareDocumentPosition(activityHeading) & Node.DOCUMENT_POSITION_FOLLOWING)).toBe(true);
         expect(await screen.findByText('Task added: Investigate bootstrap timeouts')).toBeInTheDocument();
-        await user.click(screen.getByRole('button', { name: 'Recent activity (1)' }));
+        await user.click(screen.getByRole('button', { name: 'Recent Activity (1)' }));
         expect(screen.queryByText('Task added: Investigate bootstrap timeouts')).not.toBeInTheDocument();
     });
     it('wires workstream context caption and remove actions through planning callbacks', async () => {

package/dist/components/views/standalone/modals/AccountHubModal.d.ts

@@ -56,6 +56,7 @@ interface AccountHubModalProps {
     onStartCheckout: () => void;
     onToggleWorkspaceSync: (enabled: boolean) => void;
     onOpenHelp: () => void;
+    supportMailtoHref: string;
 }
-export declare function AccountHubModal({ isOpen, theme, runtimeMode, authRequiredForApi, isAuthenticated, hasAuthIdentity, authIdentityLabel, billingLoading, billingError, billingActionError, billingNotice, billingActionBusy, billingIntervalChoice, accountProfileSummary, currentWorkspaceId, canOpenTeamManagement, canManageWorkspaceSync, workspaceCloudSyncEnabled, syncStatusLabel, workspaceSyncError, syncControlBusy, cloudAuthEnabled, availableAuthProviders, onFetchLoginMethods, onUnlinkLoginMethod, onAddPassword, onLinkProvider, onClose, onOpenWorkspaceAudit, onBillingIntervalChange, onRefreshBilling, onUpdateInterval, onManageBilling, onStartCheckout, onToggleWorkspaceSync, onOpenHelp, }: AccountHubModalProps): import("react/jsx-runtime").JSX.Element;
+export declare function AccountHubModal({ isOpen, theme, runtimeMode, authRequiredForApi, isAuthenticated, hasAuthIdentity, authIdentityLabel, billingLoading, billingError, billingActionError, billingNotice, billingActionBusy, billingIntervalChoice, accountProfileSummary, currentWorkspaceId, canOpenTeamManagement, canManageWorkspaceSync, workspaceCloudSyncEnabled, syncStatusLabel, workspaceSyncError, syncControlBusy, cloudAuthEnabled, availableAuthProviders, onFetchLoginMethods, onUnlinkLoginMethod, onAddPassword, onLinkProvider, onClose, onOpenWorkspaceAudit, onBillingIntervalChange, onRefreshBilling, onUpdateInterval, onManageBilling, onStartCheckout, onToggleWorkspaceSync, onOpenHelp, supportMailtoHref, }: AccountHubModalProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/views/standalone/modals/AccountHubModal.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState, useEffect } from 'react';
+import { Mail } from 'lucide-react';
 import { Modal } from '../../../ui/Modal';
 import modalStyles from '../../../ui/Modal.module.css';
 import accountStyles from '../../StandaloneAccount.module.css';
@@ -8,7 +9,7 @@ import managementStyles from '../../StandaloneManagement.module.css';
 import styles from '../../../../Taskforce.module.css';
 import { resolveCommercialLifecyclePresentation } from '../../../../utils/commercialLifecyclePresentation';
 import { getPasswordPolicyGuidance, validatePasswordPolicy } from '../../../../shared/passwordPolicy';
-export function AccountHubModal({ isOpen, theme, runtimeMode, authRequiredForApi, isAuthenticated, hasAuthIdentity, authIdentityLabel, billingLoading, billingError, billingActionError, billingNotice, billingActionBusy, billingIntervalChoice, accountProfileSummary, currentWorkspaceId, canOpenTeamManagement, canManageWorkspaceSync, workspaceCloudSyncEnabled, syncStatusLabel, workspaceSyncError, syncControlBusy, cloudAuthEnabled, availableAuthProviders, onFetchLoginMethods, onUnlinkLoginMethod, onAddPassword, onLinkProvider, onClose, onOpenWorkspaceAudit, onBillingIntervalChange, onRefreshBilling, onUpdateInterval, onManageBilling, onStartCheckout, onToggleWorkspaceSync, onOpenHelp, }) {
+export function AccountHubModal({ isOpen, theme, runtimeMode, authRequiredForApi, isAuthenticated, hasAuthIdentity, authIdentityLabel, billingLoading, billingError, billingActionError, billingNotice, billingActionBusy, billingIntervalChoice, accountProfileSummary, currentWorkspaceId, canOpenTeamManagement, canManageWorkspaceSync, workspaceCloudSyncEnabled, syncStatusLabel, workspaceSyncError, syncControlBusy, cloudAuthEnabled, availableAuthProviders, onFetchLoginMethods, onUnlinkLoginMethod, onAddPassword, onLinkProvider, onClose, onOpenWorkspaceAudit, onBillingIntervalChange, onRefreshBilling, onUpdateInterval, onManageBilling, onStartCheckout, onToggleWorkspaceSync, onOpenHelp, supportMailtoHref, }) {
     const lifecyclePresentation = resolveCommercialLifecyclePresentation(accountProfileSummary);
     const addPasswordGuidance = getPasswordPolicyGuidance();
     const billingRecoveryMessage = lifecyclePresentation.message;
@@ -104,5 +105,5 @@ export function AccountHubModal({ isOpen, theme, runtimeMode, authRequiredForApi
                                 ? (workspaceCloudSyncEnabled
                                     ? `Enabled · ${syncStatusLabel}`
                                     : 'Disabled')
-                                : 'Sign in to cloud account to enable workspace sync.' }), workspaceSyncError && (_jsx("p", { className: `${authStyles.loginError} ${managementStyles.errorText}`, children: workspaceSyncError })), _jsx("div", { className: managementStyles.actionRowEnd, children: _jsx("button", { className: styles.cancelBtn, disabled: !canManageWorkspaceSync || syncControlBusy, onClick: () => onToggleWorkspaceSync(!workspaceCloudSyncEnabled), children: workspaceCloudSyncEnabled ? 'Disable Sync' : 'Enable Sync' }) })] }), _jsxs("div", { className: `${modalStyles.formActions} ${managementStyles.modalActionsEnd}`, children: [_jsx("button", { className: styles.cancelBtn, onClick: onOpenHelp, children: "Help & Tutorial" }), _jsx("button", { className: styles.submitBtn, onClick: onClose, children: "Close" })] })] }) }));
+                                : 'Sign in to cloud account to enable workspace sync.' }), workspaceSyncError && (_jsx("p", { className: `${authStyles.loginError} ${managementStyles.errorText}`, children: workspaceSyncError })), _jsx("div", { className: managementStyles.actionRowEnd, children: _jsx("button", { className: styles.cancelBtn, disabled: !canManageWorkspaceSync || syncControlBusy, onClick: () => onToggleWorkspaceSync(!workspaceCloudSyncEnabled), children: workspaceCloudSyncEnabled ? 'Disable Sync' : 'Enable Sync' }) })] }), _jsxs("div", { className: `${modalStyles.formActions} ${managementStyles.modalActionsEnd}`, children: [_jsx("button", { className: styles.cancelBtn, onClick: onOpenHelp, children: "Help & Support" }), _jsxs("a", { className: `${styles.cancelBtn} ${managementStyles.supportEmailBtn}`, href: supportMailtoHref, children: [_jsx(Mail, { size: 15 }), "Contact Support"] }), _jsx("button", { className: styles.submitBtn, onClick: onClose, children: "Close" })] })] }) }));
 }

package/dist/components/views/standalone/modals/AccountHubModal.test.js

@@ -16,7 +16,7 @@ describe('AccountHubModal', () => {
                 message: 'Your latest checkout expired. Choose a plan to continue.',
                 billingConflictCode: 'CHECKOUT_SESSION_EXPIRED',
                 planSelectionRequired: true
-            }, currentWorkspaceId: "workspace-1", canOpenTeamManagement: false, canManageWorkspaceSync: false, workspaceCloudSyncEnabled: false, syncStatusLabel: "Disabled", workspaceSyncError: null, syncControlBusy: false, cloudAuthEnabled: true, availableAuthProviders: [], onFetchLoginMethods: async () => ({ success: true, methods: [] }), onUnlinkLoginMethod: async () => ({ success: true }), onAddPassword: async () => ({ success: true }), onLinkProvider: () => { }, onClose: () => { }, onOpenWorkspaceAudit: () => { }, onBillingIntervalChange: () => { }, onRefreshBilling: () => { }, onUpdateInterval: () => { }, onManageBilling: () => { }, onStartCheckout: onStartCheckout, onToggleWorkspaceSync: () => { }, onOpenHelp: () => { } }));
+            }, currentWorkspaceId: "workspace-1", canOpenTeamManagement: false, canManageWorkspaceSync: false, workspaceCloudSyncEnabled: false, syncStatusLabel: "Disabled", workspaceSyncError: null, syncControlBusy: false, supportMailtoHref: "mailto:support@taskforcehq.ai", cloudAuthEnabled: true, availableAuthProviders: [], onFetchLoginMethods: async () => ({ success: true, methods: [] }), onUnlinkLoginMethod: async () => ({ success: true }), onAddPassword: async () => ({ success: true }), onLinkProvider: () => { }, onClose: () => { }, onOpenWorkspaceAudit: () => { }, onBillingIntervalChange: () => { }, onRefreshBilling: () => { }, onUpdateInterval: () => { }, onManageBilling: () => { }, onStartCheckout: onStartCheckout, onToggleWorkspaceSync: () => { }, onOpenHelp: () => { } }));
         expect(screen.getByText('Your previous checkout expired. Choose a plan to continue.')).toBeInTheDocument();
         expect(screen.getByText('Pro Plan')).toBeInTheDocument();
         const cta = screen.getByRole('button', { name: 'Choose Plan' });
@@ -30,21 +30,27 @@ describe('AccountHubModal', () => {
                 planName: 'Pro Plan',
                 entitlementState: 'suspended',
                 stripeCustomerId: 'cus_123'
-            }, currentWorkspaceId: "workspace-1", canOpenTeamManagement: false, canManageWorkspaceSync: false, workspaceCloudSyncEnabled: false, syncStatusLabel: "Disabled", workspaceSyncError: null, syncControlBusy: false, cloudAuthEnabled: true, availableAuthProviders: [], onFetchLoginMethods: async () => ({ success: true, methods: [] }), onUnlinkLoginMethod: async () => ({ success: true }), onAddPassword: async () => ({ success: true }), onLinkProvider: () => { }, onClose: () => { }, onOpenWorkspaceAudit: () => { }, onBillingIntervalChange: () => { }, onRefreshBilling: () => { }, onUpdateInterval: () => { }, onManageBilling: onManageBilling, onStartCheckout: () => { }, onToggleWorkspaceSync: () => { }, onOpenHelp: () => { } }));
+            }, currentWorkspaceId: "workspace-1", canOpenTeamManagement: false, canManageWorkspaceSync: false, workspaceCloudSyncEnabled: false, syncStatusLabel: "Disabled", workspaceSyncError: null, syncControlBusy: false, supportMailtoHref: "mailto:support@taskforcehq.ai", cloudAuthEnabled: true, availableAuthProviders: [], onFetchLoginMethods: async () => ({ success: true, methods: [] }), onUnlinkLoginMethod: async () => ({ success: true }), onAddPassword: async () => ({ success: true }), onLinkProvider: () => { }, onClose: () => { }, onOpenWorkspaceAudit: () => { }, onBillingIntervalChange: () => { }, onRefreshBilling: () => { }, onUpdateInterval: () => { }, onManageBilling: onManageBilling, onStartCheckout: () => { }, onToggleWorkspaceSync: () => { }, onOpenHelp: () => { } }));
         expect(screen.getByText('Your access is suspended because billing needs attention. Update billing to restore access.')).toBeInTheDocument();
         fireEvent.click(screen.getAllByRole('button', { name: 'Manage Billing' })[1]);
         expect(onManageBilling).toHaveBeenCalledTimes(1);
     });
     it('shows trialing accounts as active without blocked recovery copy', () => {
-        render(_jsx(AccountHubModal, { isOpen: true, theme: "dark", runtimeMode: "cloud", authRequiredForApi: true, isAuthenticated: true, hasAuthIdentity: true, authIdentityLabel: "owner@example.com", billingLoading: false, billingError: null, billingActionError: null, billingNotice: null, billingActionBusy: false, billingIntervalChoice: "month", accountProfileSummary: {
-                planId: 'starter',
-                planName: 'Starter',
-                entitlementState: 'trialing',
-                stripeCustomerId: 'cus_123',
-                trialEnd: '2026-05-01T12:00:00.000Z'
-            }, currentWorkspaceId: "workspace-1", canOpenTeamManagement: false, canManageWorkspaceSync: false, workspaceCloudSyncEnabled: false, syncStatusLabel: "Disabled", workspaceSyncError: null, syncControlBusy: false, cloudAuthEnabled: true, availableAuthProviders: [], onFetchLoginMethods: async () => ({ success: true, methods: [] }), onUnlinkLoginMethod: async () => ({ success: true }), onAddPassword: async () => ({ success: true }), onLinkProvider: () => { }, onClose: () => { }, onOpenWorkspaceAudit: () => { }, onBillingIntervalChange: () => { }, onRefreshBilling: () => { }, onUpdateInterval: () => { }, onManageBilling: () => { }, onStartCheckout: () => { }, onToggleWorkspaceSync: () => { }, onOpenHelp: () => { } }));
-        expect(screen.getByText(/Your trial is active through/)).toBeInTheDocument();
-        expect(screen.queryByText('Your access is suspended because billing needs attention. Update billing to restore access.')).not.toBeInTheDocument();
+        const nowSpy = vi.spyOn(Date, 'now').mockReturnValue(new Date('2026-04-20T12:00:00.000Z').getTime());
+        try {
+            render(_jsx(AccountHubModal, { isOpen: true, theme: "dark", runtimeMode: "cloud", authRequiredForApi: true, isAuthenticated: true, hasAuthIdentity: true, authIdentityLabel: "owner@example.com", billingLoading: false, billingError: null, billingActionError: null, billingNotice: null, billingActionBusy: false, billingIntervalChoice: "month", accountProfileSummary: {
+                    planId: 'starter',
+                    planName: 'Starter',
+                    entitlementState: 'trialing',
+                    stripeCustomerId: 'cus_123',
+                    trialEnd: '2026-05-01T12:00:00.000Z'
+                }, currentWorkspaceId: "workspace-1", canOpenTeamManagement: false, canManageWorkspaceSync: false, workspaceCloudSyncEnabled: false, syncStatusLabel: "Disabled", workspaceSyncError: null, syncControlBusy: false, supportMailtoHref: "mailto:support@taskforcehq.ai", cloudAuthEnabled: true, availableAuthProviders: [], onFetchLoginMethods: async () => ({ success: true, methods: [] }), onUnlinkLoginMethod: async () => ({ success: true }), onAddPassword: async () => ({ success: true }), onLinkProvider: () => { }, onClose: () => { }, onOpenWorkspaceAudit: () => { }, onBillingIntervalChange: () => { }, onRefreshBilling: () => { }, onUpdateInterval: () => { }, onManageBilling: () => { }, onStartCheckout: () => { }, onToggleWorkspaceSync: () => { }, onOpenHelp: () => { } }));
+            expect(screen.getByText(/Your trial is active through/)).toBeInTheDocument();
+            expect(screen.queryByText('Your access is suspended because billing needs attention. Update billing to restore access.')).not.toBeInTheDocument();
+        }
+        finally {
+            nowSpy.mockRestore();
+        }
     });
     it('shows an updating message instead of an expired active-trial date', () => {
         const nowSpy = vi.spyOn(Date, 'now').mockReturnValue(new Date('2026-04-20T12:00:00.000Z').getTime());
@@ -55,7 +61,7 @@ describe('AccountHubModal', () => {
                     entitlementState: 'trialing',
                     stripeCustomerId: 'cus_123',
                     trialEnd: '2026-04-12T16:09:09.000Z'
-                }, currentWorkspaceId: "workspace-1", canOpenTeamManagement: false, canManageWorkspaceSync: false, workspaceCloudSyncEnabled: false, syncStatusLabel: "Disabled", workspaceSyncError: null, syncControlBusy: false, cloudAuthEnabled: true, availableAuthProviders: [], onFetchLoginMethods: async () => ({ success: true, methods: [] }), onUnlinkLoginMethod: async () => ({ success: true }), onAddPassword: async () => ({ success: true }), onLinkProvider: () => { }, onClose: () => { }, onOpenWorkspaceAudit: () => { }, onBillingIntervalChange: () => { }, onRefreshBilling: () => { }, onUpdateInterval: () => { }, onManageBilling: () => { }, onStartCheckout: () => { }, onToggleWorkspaceSync: () => { }, onOpenHelp: () => { } }));
+                }, currentWorkspaceId: "workspace-1", canOpenTeamManagement: false, canManageWorkspaceSync: false, workspaceCloudSyncEnabled: false, syncStatusLabel: "Disabled", workspaceSyncError: null, syncControlBusy: false, supportMailtoHref: "mailto:support@taskforcehq.ai", cloudAuthEnabled: true, availableAuthProviders: [], onFetchLoginMethods: async () => ({ success: true, methods: [] }), onUnlinkLoginMethod: async () => ({ success: true }), onAddPassword: async () => ({ success: true }), onLinkProvider: () => { }, onClose: () => { }, onOpenWorkspaceAudit: () => { }, onBillingIntervalChange: () => { }, onRefreshBilling: () => { }, onUpdateInterval: () => { }, onManageBilling: () => { }, onStartCheckout: () => { }, onToggleWorkspaceSync: () => { }, onOpenHelp: () => { } }));
             expect(screen.getByText('Your trial end date has passed. Billing status is updating.')).toBeInTheDocument();
             expect(screen.queryByText(/Your trial is active through/)).not.toBeInTheDocument();
         }

package/dist/components/views/standalone/modals/HelpModal.d.ts

@@ -4,6 +4,8 @@ interface HelpModalProps {
     theme: ModalThemeName;
     onClose: () => void;
     onOpenSettings: () => void;
+    onOpenAccountHub?: () => void;
+    supportMailtoHref: string;
 }
-export declare function HelpModal({ isOpen, theme, onClose, onOpenSettings, }: HelpModalProps): import("react/jsx-runtime").JSX.Element;
+export declare function HelpModal({ isOpen, theme, onClose, onOpenSettings, onOpenAccountHub, supportMailtoHref, }: HelpModalProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/views/standalone/modals/HelpModal.js

@@ -1,8 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Mail, Settings, UserCircle, Wrench } from 'lucide-react';
 import { Modal } from '../../../ui/Modal';
 import modalStyles from '../../../ui/Modal.module.css';
 import managementStyles from '../../StandaloneManagement.module.css';
 import styles from '../../../../Taskforce.module.css';
-export function HelpModal({ isOpen, theme, onClose, onOpenSettings, }) {
-    return (_jsx(Modal, { isOpen: isOpen, onClose: onClose, title: "Quick Start", size: "md", theme: theme, draggable: true, children: _jsxs("div", { className: `${modalStyles.form} ${managementStyles.modalBody}`, children: [_jsx("p", { className: managementStyles.mutedText, children: "Use this quick guide to get productive in Taskforce dashboard mode." }), _jsxs("div", { children: [_jsx("strong", { children: "1. Capture work" }), _jsxs("p", { className: managementStyles.sectionText, children: ["Click ", _jsx("code", { children: "Add Task" }), ", write a short title, and save."] })] }), _jsxs("div", { children: [_jsx("strong", { children: "2. Plan the board" }), _jsxs("p", { className: managementStyles.sectionText, children: ["Use ", _jsx("code", { children: "Sort" }), ", ", _jsx("code", { children: "Group" }), ", and ", _jsx("code", { children: "Filters" }), " in the header."] })] }), _jsxs("div", { children: [_jsx("strong", { children: "3. Execute and stage" }), _jsxs("p", { className: managementStyles.sectionText, children: ["Move tasks through ", _jsx("code", { children: "Task" }), ", ", _jsx("code", { children: "In Progress" }), ", ", _jsx("code", { children: "Review" }), ", and ", _jsx("code", { children: "Done" }), "."] })] }), _jsxs("div", { children: [_jsx("strong", { children: "4. Archive finished work" }), _jsx("p", { className: managementStyles.sectionText, children: "Archive completed/cancelled tasks to keep active board signal high." })] }), _jsxs("div", { className: `${modalStyles.formActions} ${managementStyles.modalActionsEnd}`, children: [_jsx("button", { className: styles.cancelBtn, onClick: onOpenSettings, children: "Open Settings" }), _jsx("button", { className: styles.submitBtn, onClick: onClose, children: "Close Tutorial" })] })] }) }));
+import { TASKFORCE_SUPPORT_EMAIL } from '../../../../utils/supportContact';
+export function HelpModal({ isOpen, theme, onClose, onOpenSettings, onOpenAccountHub, supportMailtoHref, }) {
+    return (_jsx(Modal, { isOpen: isOpen, onClose: onClose, title: "Help & Support", size: "md", theme: theme, draggable: true, children: _jsxs("div", { className: `${modalStyles.form} ${managementStyles.modalBody}`, children: [_jsxs("div", { className: managementStyles.helpIntro, children: [_jsx("p", { className: "tf-text-body", children: "Need a hand with Taskforce? Email support with what you were trying to do, what happened, and any workspace context that would help us reproduce it." }), _jsxs("a", { className: `${styles.submitBtn} ${managementStyles.supportEmailBtn}`, href: supportMailtoHref, children: [_jsx(Mail, { size: 16 }), "Email Support"] }), _jsxs("p", { className: "tf-text-helper", children: ["Opens your email client to ", TASKFORCE_SUPPORT_EMAIL, "."] })] }), _jsxs("div", { className: `${managementStyles.supportPanel} tf-surface-panel`, children: [_jsxs("div", { className: managementStyles.supportPanelHeader, children: [_jsx(Wrench, { size: 16 }), _jsxs("div", { children: [_jsx("h3", { className: "tf-heading-card", children: "Before you email" }), _jsx("p", { className: "tf-text-secondary", children: "These are the fastest places to check for common workspace, account, and setup issues." })] })] }), _jsxs("div", { className: managementStyles.supportRouteList, children: [_jsxs("button", { className: `${styles.cancelBtn} ${managementStyles.supportRouteBtn}`, onClick: onOpenSettings, children: [_jsx(Settings, { size: 15 }), "Open Settings"] }), onOpenAccountHub && (_jsxs("button", { className: `${styles.cancelBtn} ${managementStyles.supportRouteBtn}`, onClick: onOpenAccountHub, children: [_jsx(UserCircle, { size: 15 }), "Open Account Hub"] }))] })] }), _jsx("div", { className: `${modalStyles.formActions} ${managementStyles.modalActionsEnd}`, children: _jsx("button", { className: styles.cancelBtn, onClick: onClose, children: "Close" }) })] }) }));
 }

package/dist/components/views/standalone/modals/HelpModal.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/views/standalone/modals/HelpModal.test.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+import { TASKFORCE_SUPPORT_EMAIL } from '../../../../utils/supportContact';
+import { HelpModal } from './HelpModal';
+vi.mock('../../../ui/Modal', () => ({
+    Modal: ({ isOpen, children, title }) => (isOpen ? _jsxs("div", { children: [_jsx("h1", { children: title }), children] }) : null)
+}));
+describe('HelpModal', () => {
+    it('presents support actions instead of tutorial steps', () => {
+        const onOpenSettings = vi.fn();
+        const onOpenAccountHub = vi.fn();
+        render(_jsx(HelpModal, { isOpen: true, theme: "dark", onClose: () => { }, onOpenSettings: onOpenSettings, onOpenAccountHub: onOpenAccountHub, supportMailtoHref: `mailto:${TASKFORCE_SUPPORT_EMAIL}` }));
+        expect(screen.getByRole('heading', { name: 'Help & Support' })).toBeInTheDocument();
+        expect(screen.getByRole('link', { name: 'Email Support' })).toHaveAttribute('href', `mailto:${TASKFORCE_SUPPORT_EMAIL}`);
+        expect(screen.queryByText('Close Tutorial')).not.toBeInTheDocument();
+        expect(screen.queryByText('Capture work')).not.toBeInTheDocument();
+        fireEvent.click(screen.getByRole('button', { name: 'Open Settings' }));
+        expect(onOpenSettings).toHaveBeenCalledTimes(1);
+        fireEvent.click(screen.getByRole('button', { name: 'Open Account Hub' }));
+        expect(onOpenAccountHub).toHaveBeenCalledTimes(1);
+    });
+});