npm - @taskforcehq/taskforce - Versions diffs - 0.3.301 → 0.3.303 - Mend

@taskforcehq/taskforce 0.3.301 → 0.3.303

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (171) hide show

package/dist/Taskforce.module.css +37 -2
package/dist/TaskforceCore.filter-persistence.test.js +1 -1
package/dist/TaskforceCore.js +72 -33
package/dist/TaskforceCore.test.js +848 -130
package/dist/components/features/TaskSettings.js +14 -82
package/dist/components/features/TaskSettings.test.js +33 -70
package/dist/components/features/settings/TaxonomyLibraryManager.js +8 -2
package/dist/components/features/settings/TaxonomyLibraryManager.test.js +1 -1
package/dist/components/task/TaskActionHeader.js +6 -3
package/dist/components/task/TaskCard.js +6 -3
package/dist/components/task/TaskForm.js +2 -2
package/dist/components/task/TaskForm.test.js +41 -2
package/dist/components/task/TaskKanban.test.js +17 -0
package/dist/components/ui/ReferenceBadgeButton.js +1 -1
package/dist/components/views/PlansPage.d.ts +3 -1
package/dist/components/views/PlansPage.js +109 -49
package/dist/components/views/PlansPage.test.d.ts +1 -0
package/dist/components/views/PlansPage.test.js +100 -0
package/dist/components/views/StandaloneLayout.d.ts +1 -0
package/dist/components/views/StandaloneLayout.js +473 -256
package/dist/components/views/panels/PlanningDrawer.js +18 -1
package/dist/components/views/standalone/modals/AccountHubModal.d.ts +48 -0
package/dist/components/views/standalone/modals/AccountHubModal.js +36 -0
package/dist/components/views/standalone/modals/AccountHubModal.test.d.ts +1 -0
package/dist/components/views/standalone/modals/AccountHubModal.test.js +26 -0
package/dist/components/views/standalone/modals/CreateWorkspaceConfirmModal.d.ts +9 -0
package/dist/components/views/standalone/modals/CreateWorkspaceConfirmModal.js +8 -0
package/dist/components/views/standalone/modals/EditProfileModal.d.ts +26 -0
package/dist/components/views/standalone/modals/EditProfileModal.js +10 -0
package/dist/components/views/standalone/modals/HelpModal.d.ts +9 -0
package/dist/components/views/standalone/modals/HelpModal.js +8 -0
package/dist/components/views/standalone/modals/ScheduleWarningModal.d.ts +13 -0
package/dist/components/views/standalone/modals/ScheduleWarningModal.js +6 -0
package/dist/components/views/standalone/modals/SyncStatusModal.d.ts +61 -0
package/dist/components/views/standalone/modals/SyncStatusModal.js +38 -0
package/dist/components/views/standalone/modals/TeamManagementModal.d.ts +64 -0
package/dist/components/views/standalone/modals/TeamManagementModal.js +10 -0
package/dist/components/views/standalone/modals/types.d.ts +2 -0
package/dist/components/views/standalone/modals/types.js +1 -0
package/dist/components/views/teamManagementAccess.d.ts +1 -1
package/dist/components/views/teamManagementAccess.js +2 -2
package/dist/components/views/teamManagementAccess.test.js +3 -3
package/dist/config/deployment.js +2 -2
package/dist/config/deployment.test.js +5 -3
package/dist/core/AiProfileService.js +7 -2
package/dist/core/AiProfiles.test.js +19 -0
package/dist/core/EntitlementsPolicy.test.js +2 -2
package/dist/core/GlobalSettingsService.js +78 -18
package/dist/core/PlanEntitlementService.d.ts +29 -5
package/dist/core/PlanEntitlementService.js +297 -219
package/dist/core/SignupMonetizationSettings.test.js +173 -49
package/dist/core/SyncReconciliationService.d.ts +2 -0
package/dist/core/SyncReconciliationService.js +3 -0
package/dist/core/SystemAdmin.test.js +186 -96
package/dist/core/TaskAuditTimeline.test.js +40 -0
package/dist/core/Taskforce.d.ts +100 -10
package/dist/core/Taskforce.ids.test.js +133 -0
package/dist/core/Taskforce.js +459 -127
package/dist/core/Taskforce.mcpAuth.test.js +0 -2
package/dist/core/UserProfileAvatarDrafts.test.d.ts +1 -0
package/dist/core/UserProfileAvatarDrafts.test.js +111 -0
package/dist/core/taskReferencePolicy.d.ts +28 -0
package/dist/core/taskReferencePolicy.js +189 -0
package/dist/core/types.d.ts +13 -12
package/dist/hooks/tasks/useTaskFormActions.js +3 -0
package/dist/hooks/useSyncOrchestrator.js +17 -3
package/dist/hooks/useSyncOrchestrator.retry-closure.test.js +97 -5
package/dist/hooks/useTaskData.js +3 -2
package/dist/hooks/useTaskData.test.js +66 -0
package/dist/hooks/useTaskforce.d.ts +8 -0
package/dist/hooks/useTaskforce.js +72 -19
package/dist/hooks/useTaskforce.sync-behavior.test.js +185 -6
package/dist/mcp/aiProfileBootstrap.d.ts +29 -0
package/dist/mcp/aiProfileBootstrap.js +80 -0
package/dist/mcp/aiProfileBootstrap.test.d.ts +1 -0
package/dist/mcp/aiProfileBootstrap.test.js +68 -0
package/dist/mcp/clientIntegrations.d.ts +2 -8
package/dist/mcp/clientIntegrations.js +21 -40
package/dist/mcp/clientIntegrations.test.js +28 -2
package/dist/mcp/clientProfileDefaults.d.ts +12 -0
package/dist/mcp/clientProfileDefaults.js +37 -0
package/dist/mcp/runtime.d.ts +10 -7
package/dist/mcp/runtime.js +131 -48
package/dist/mcp/runtime.test.js +321 -83
package/dist/migrations/billingSchemaParity.test.js +3 -0
package/dist/migrations/taskSchemaMigrations.js +68 -1
package/dist/qaOpen.test.d.ts +1 -0
package/dist/qaOpen.test.js +56 -0
package/dist/server/index.cookieProxy.test.js +2 -0
package/dist/server/index.d.ts +1 -0
package/dist/server/index.js +17 -1
package/dist/server/index.test.js +15 -1
package/dist/server/mockStripe.d.ts +1 -0
package/dist/server/mockStripe.js +2 -0
package/dist/server/routes/admin.js +105 -45
package/dist/server/routes/auth.d.ts +6 -0
package/dist/server/routes/auth.js +505 -30
package/dist/server/routes/billing.js +517 -24
package/dist/server/routes/billing.test.js +967 -45
package/dist/server/routes/documents.js +6 -1
package/dist/server/routes/shared.d.ts +1 -1
package/dist/server/routes/shared.js +16 -6
package/dist/server/routes/sync.integration.test.js +290 -0
package/dist/server/routes/sync.js +234 -1922
package/dist/server/routes/tasks.js +18 -4
package/dist/server/routes.js +29 -22
package/dist/server/routes.test.js +639 -82
package/dist/shared/runtimeContract.d.ts +1 -1
package/dist/sync/cloudSyncApi.d.ts +1 -0
package/dist/sync/collaborationSyncPayload.d.ts +17 -0
package/dist/sync/collaborationSyncPayload.js +131 -0
package/dist/sync/collaborationSyncPayload.test.d.ts +1 -0
package/dist/sync/collaborationSyncPayload.test.js +104 -0
package/dist/sync/collaborationSyncState.d.ts +15 -0
package/dist/sync/collaborationSyncState.js +60 -0
package/dist/sync/contentSyncPayload.d.ts +45 -0
package/dist/sync/contentSyncPayload.js +104 -0
package/dist/sync/contentSyncPayload.test.d.ts +1 -0
package/dist/sync/contentSyncPayload.test.js +104 -0
package/dist/sync/contentSyncState.d.ts +98 -0
package/dist/sync/contentSyncState.js +1004 -0
package/dist/sync/planningSyncPayload.d.ts +9 -0
package/dist/sync/planningSyncPayload.js +82 -0
package/dist/sync/planningSyncPayload.test.d.ts +1 -0
package/dist/sync/planningSyncPayload.test.js +68 -0
package/dist/sync/syncApplyHandlers.d.ts +83 -0
package/dist/sync/syncApplyHandlers.js +445 -0
package/dist/sync/syncService.d.ts +1 -0
package/dist/sync/syncService.js +21 -8
package/dist/sync/taskSyncPayload.d.ts +33 -0
package/dist/sync/taskSyncPayload.js +126 -0
package/dist/sync/taskSyncPayload.test.d.ts +1 -0
package/dist/sync/taskSyncPayload.test.js +54 -0
package/dist/sync/workspacePullFeed.d.ts +38 -0
package/dist/sync/workspacePullFeed.js +349 -0
package/dist/sync/workspacePullFeed.test.d.ts +1 -0
package/dist/sync/workspacePullFeed.test.js +278 -0
package/dist/sync/workspaceSyncModel.d.ts +4 -1
package/dist/sync/workspaceSyncModel.js +9 -2
package/dist/sync/workspaceSyncModel.test.js +29 -0
package/dist/test/setup.js +1 -1
package/dist/types.d.ts +1 -0
package/dist/ui/assets/{AgentsModule-Bdq3T1Ts.js → AgentsModule-CpsTmrIW.js} +1 -1
package/dist/ui/assets/{AnnotatedAttachmentWorkspace-jKUVo-PJ.js → AnnotatedAttachmentWorkspace-C_TmXZwA.js} +1 -1
package/dist/ui/assets/{DocumentWorkspace-DuQa-uIC.js → DocumentWorkspace-C3GyzrWm.js} +2 -2
package/dist/ui/assets/{InitiativesModule-C8Pi2VTk.js → InitiativesModule-4-Rh2K2n.js} +1 -1
package/dist/ui/assets/PlansPage-BP7AYOqr.js +1 -0
package/dist/ui/assets/TaskSettings-BOC5F6Ag.js +8 -0
package/dist/ui/assets/{TaskSettings-BwB9NtmJ.css → TaskSettings-CnIBL_Eb.css} +1 -1
package/dist/ui/assets/{WorkflowsModule-b6TLuHwJ.js → WorkflowsModule-CGk9s3NJ.js} +1 -1
package/dist/ui/assets/index-CLIMgR6g.js +6 -0
package/dist/ui/assets/index-DneETxcu.css +1 -0
package/dist/ui/assets/{vendor-icons-QZyhEwgT.js → vendor-icons-pWocEipT.js} +1 -1
package/dist/ui/index.html +3 -3
package/dist/utils/accountProfileSummaryCache.d.ts +31 -0
package/dist/utils/accountProfileSummaryCache.js +97 -0
package/dist/utils/accountProfileSummaryCache.test.d.ts +1 -0
package/dist/utils/accountProfileSummaryCache.test.js +63 -0
package/dist/utils/taskActivity.js +17 -4
package/dist/utils/taskActivity.test.js +27 -0
package/dist/utils/taskNormalization.js +10 -2
package/dist/utils/taskReferences.d.ts +11 -1
package/dist/utils/taskReferences.js +33 -1
package/package.json +4 -3
package/scripts/qa-open-lib.mjs +175 -0
package/scripts/qa-open-lib.mjs.d.ts +49 -0
package/scripts/qa-open.mjs +352 -0
package/dist/ui/assets/PlansPage-B6BDECSi.js +0 -1
package/dist/ui/assets/TaskSettings-DUJgRTPU.js +0 -8
package/dist/ui/assets/index-BiiF1cLQ.css +0 -1
package/dist/ui/assets/index-xBWLPOEb.js +0 -6

package/dist/ui/index.html CHANGED Viewed

@@ -8,13 +8,13 @@
     <link rel="icon" type="image/png" sizes="16x16" href="/favicon/favicon-16x16.png" />
     <link rel="apple-touch-icon" href="/taskforce/favicon/apple-touch-icon.png" />
     <title>Taskforce Dashboard</title>
-    <script type="module" crossorigin src="/taskforce/assets/index-xBWLPOEb.js"></script>
+    <script type="module" crossorigin src="/taskforce/assets/index-CLIMgR6g.js"></script>
     <link rel="modulepreload" crossorigin href="/taskforce/assets/vendor-react-CKJs5o3c.js">
-    <link rel="modulepreload" crossorigin href="/taskforce/assets/vendor-icons-QZyhEwgT.js">
+    <link rel="modulepreload" crossorigin href="/taskforce/assets/vendor-icons-pWocEipT.js">
     <link rel="modulepreload" crossorigin href="/taskforce/assets/vendor-markdown-BUxTU7dS.js">
     <link rel="modulepreload" crossorigin href="/taskforce/assets/vendor-dnd-DRzYolkg.js">
     <link rel="modulepreload" crossorigin href="/taskforce/assets/vendor-router-BbWMxlnO.js">
-    <link rel="stylesheet" crossorigin href="/taskforce/assets/index-BiiF1cLQ.css">
+    <link rel="stylesheet" crossorigin href="/taskforce/assets/index-DneETxcu.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/utils/accountProfileSummaryCache.d.ts ADDED Viewed

@@ -0,0 +1,31 @@
+export declare const ACCOUNT_PROFILE_SUMMARY_PATH = "/api/taskforce/account/profile-summary";
+export type AccountProfileSummary = {
+    stripeStatus?: string | null;
+    stripeCustomerId?: string | null;
+    stripeSubscriptionId?: string | null;
+    stripePriceId?: string | null;
+    billingInterval?: 'month' | 'year' | null;
+    trialEnd?: string | null;
+    currentPeriodEnd?: string | null;
+    effectiveUntil?: string | null;
+    entitlementState?: string;
+    planVersionId?: string;
+    planId?: string;
+    planName?: string | null;
+    gate?: string | null;
+    message?: string | null;
+    billingConflictCode?: 'CHECKOUT_SESSION_EXPIRED' | 'CHECKOUT_SESSION_SUPERSEDED' | null;
+    planSelectionRequired?: boolean;
+    workspaceId?: string | null;
+    workspaceRole?: 'owner' | 'admin' | 'member' | 'read-only' | null;
+    canManageWorkspace?: boolean;
+    teamPlanMode?: 'personal' | 'team' | 'unknown';
+    teamManagementAllowed?: boolean;
+};
+export declare function invalidateAccountProfileSummaryCache(rawUrl: string, options?: {
+    identityKey?: string | null;
+}): void;
+export declare function loadAccountProfileSummaryCached(rawUrl: string, options?: {
+    force?: boolean;
+    identityKey?: string | null;
+}): Promise<AccountProfileSummary | null>;

package/dist/utils/accountProfileSummaryCache.js ADDED Viewed

@@ -0,0 +1,97 @@
+import { logBootstrapDebug } from '../hooks/workspace/workspaceLocalState';
+export const ACCOUNT_PROFILE_SUMMARY_PATH = '/api/taskforce/account/profile-summary';
+const ACCOUNT_PROFILE_SUMMARY_CACHE_TTL_MS = 90_000;
+const accountProfileSummaryCache = new Map();
+function getTimingNow() {
+    return typeof performance !== 'undefined' ? performance.now() : Date.now();
+}
+function normalizeAccountProfileSummaryCacheKey(rawUrl, identityKey) {
+    const url = String(rawUrl || '').trim();
+    if (!url)
+        return '';
+    const normalizedIdentityKey = String(identityKey || '').trim();
+    return normalizedIdentityKey ? `${url}::${normalizedIdentityKey}` : url;
+}
+export function invalidateAccountProfileSummaryCache(rawUrl, options) {
+    accountProfileSummaryCache.delete(normalizeAccountProfileSummaryCacheKey(rawUrl, options?.identityKey));
+}
+export async function loadAccountProfileSummaryCached(rawUrl, options) {
+    const url = String(rawUrl || '').trim();
+    const cacheKey = normalizeAccountProfileSummaryCacheKey(rawUrl, options?.identityKey);
+    if (!cacheKey || !url)
+        return null;
+    const force = options?.force === true;
+    const now = Date.now();
+    const cached = accountProfileSummaryCache.get(cacheKey);
+    if (!force && cached?.payload !== undefined && (now - cached.fetchedAt) < ACCOUNT_PROFILE_SUMMARY_CACHE_TTL_MS) {
+        logBootstrapDebug('account_profile_summary_cache_hit', {
+            url,
+            cacheKey,
+            ageMs: now - cached.fetchedAt
+        });
+        return cached.payload;
+    }
+    if (!force && cached?.promise) {
+        logBootstrapDebug('account_profile_summary_request_reused', {
+            url,
+            cacheKey
+        });
+        return cached.promise;
+    }
+    const startedAt = getTimingNow();
+    const request = (async () => {
+        const res = await fetch(url, {
+            method: 'GET',
+            credentials: 'include'
+        });
+        if (!res.ok) {
+            throw new Error(String((await res.json().catch(() => ({})))?.error || 'Failed to load account summary.'));
+        }
+        const payload = await res.json().catch(() => ({}));
+        const normalized = (payload || null);
+        accountProfileSummaryCache.set(cacheKey, {
+            payload: normalized,
+            fetchedAt: Date.now(),
+            promise: null
+        });
+        logBootstrapDebug('account_profile_summary_loaded', {
+            url,
+            cacheKey,
+            durationMs: Math.round(getTimingNow() - startedAt),
+            fromCache: false
+        });
+        return normalized;
+    })().catch((error) => {
+        const stalePayload = cached?.payload ?? null;
+        if (stalePayload) {
+            accountProfileSummaryCache.set(cacheKey, {
+                payload: stalePayload,
+                fetchedAt: cached?.fetchedAt ?? Date.now(),
+                promise: null
+            });
+            logBootstrapDebug('account_profile_summary_failed', {
+                url,
+                cacheKey,
+                durationMs: Math.round(getTimingNow() - startedAt),
+                error: error instanceof Error ? error.message : String(error || 'Unknown error'),
+                returnedStale: true
+            });
+            return stalePayload;
+        }
+        accountProfileSummaryCache.delete(cacheKey);
+        logBootstrapDebug('account_profile_summary_failed', {
+            url,
+            cacheKey,
+            durationMs: Math.round(getTimingNow() - startedAt),
+            error: error instanceof Error ? error.message : String(error || 'Unknown error'),
+            returnedStale: false
+        });
+        throw error;
+    });
+    accountProfileSummaryCache.set(cacheKey, {
+        payload: cached?.payload ?? null,
+        fetchedAt: cached?.fetchedAt ?? 0,
+        promise: request
+    });
+    return request;
+}

package/dist/utils/accountProfileSummaryCache.test.d.ts ADDED Viewed

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

package/dist/utils/accountProfileSummaryCache.test.js ADDED Viewed

@@ -0,0 +1,63 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { ACCOUNT_PROFILE_SUMMARY_PATH, invalidateAccountProfileSummaryCache, loadAccountProfileSummaryCached } from './accountProfileSummaryCache';
+describe('accountProfileSummaryCache', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.useRealTimers();
+        invalidateAccountProfileSummaryCache(ACCOUNT_PROFILE_SUMMARY_PATH, { identityKey: 'user-a' });
+        invalidateAccountProfileSummaryCache(ACCOUNT_PROFILE_SUMMARY_PATH, { identityKey: 'user-b' });
+    });
+    it('keeps account summaries isolated per authenticated user', async () => {
+        const fetchMock = vi.fn()
+            .mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({ planId: 'team-5', planVersionId: 'team-5-v1' })
+        })
+            .mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({ planId: 'starter', planVersionId: 'starter-v1' })
+        });
+        vi.stubGlobal('fetch', fetchMock);
+        const first = await loadAccountProfileSummaryCached(ACCOUNT_PROFILE_SUMMARY_PATH, { identityKey: 'user-a' });
+        const second = await loadAccountProfileSummaryCached(ACCOUNT_PROFILE_SUMMARY_PATH, { identityKey: 'user-b' });
+        expect(first?.planId).toBe('team-5');
+        expect(second?.planId).toBe('starter');
+        expect(fetchMock).toHaveBeenCalledTimes(2);
+        expect(fetchMock).toHaveBeenNthCalledWith(1, ACCOUNT_PROFILE_SUMMARY_PATH, expect.any(Object));
+        expect(fetchMock).toHaveBeenNthCalledWith(2, ACCOUNT_PROFILE_SUMMARY_PATH, expect.any(Object));
+    });
+    it('reuses the cached summary inside the cache window', async () => {
+        vi.useFakeTimers();
+        const fetchMock = vi.fn().mockResolvedValue({
+            ok: true,
+            json: async () => ({ planId: 'team-5', planVersionId: 'team-5-v1' })
+        });
+        vi.stubGlobal('fetch', fetchMock);
+        const first = await loadAccountProfileSummaryCached(ACCOUNT_PROFILE_SUMMARY_PATH, { identityKey: 'user-a' });
+        vi.advanceTimersByTime(30_000);
+        const second = await loadAccountProfileSummaryCached(ACCOUNT_PROFILE_SUMMARY_PATH, { identityKey: 'user-a' });
+        expect(first?.planId).toBe('team-5');
+        expect(second?.planId).toBe('team-5');
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+    });
+    it('returns the last successful summary when a forced refresh fails', async () => {
+        const fetchMock = vi.fn()
+            .mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({ planId: 'team-5', planVersionId: 'team-5-v1', teamManagementAllowed: true })
+        })
+            .mockResolvedValueOnce({
+            ok: false,
+            json: async () => ({ error: 'Stripe unavailable' })
+        });
+        vi.stubGlobal('fetch', fetchMock);
+        const warm = await loadAccountProfileSummaryCached(ACCOUNT_PROFILE_SUMMARY_PATH, { identityKey: 'user-a' });
+        const refreshed = await loadAccountProfileSummaryCached(ACCOUNT_PROFILE_SUMMARY_PATH, {
+            identityKey: 'user-a',
+            force: true
+        });
+        expect(warm?.planId).toBe('team-5');
+        expect(refreshed).toEqual(warm);
+        expect(fetchMock).toHaveBeenCalledTimes(2);
+    });
+});

package/dist/utils/taskActivity.js CHANGED Viewed

@@ -1,3 +1,12 @@
+function getActivityFieldLabel(field) {
+    if (field === 'title')
+        return 'TITLE';
+    if (field === 'description')
+        return 'DESCRIPTION';
+    if (field === 'assignee')
+        return 'ASSIGNED TO';
+    return field;
+}
 function formatValue(value, field, formatter) {
     const formatted = formatter?.(field, value);
     if (typeof formatted === 'string')
@@ -66,16 +75,20 @@ export function summarizeTaskChange(field, change, formatter) {
     if (field === 'checklistItems') {
         return summarizeChecklistChange(change);
     }
+    const label = getActivityFieldLabel(field);
+    if (field === 'title') {
+        return `${label}: updated`;
+    }
     if (field === 'description') {
         const hadBefore = formatValue(change?.from, field, formatter) !== 'none';
         const hasAfter = formatValue(change?.to, field, formatter) !== 'none';
         if (!hadBefore && hasAfter)
-            return 'Description added';
+            return `${label}: added`;
         if (hadBefore && !hasAfter)
-            return 'Description cleared';
-        return 'Description updated';
+            return `${label}: cleared`;
+        return `${label}: updated`;
     }
-    return `${field}: ${formatValue(change?.from, field, formatter)} -> ${formatValue(change?.to, field, formatter)}`;
+    return `${label}: ${formatValue(change?.from, field, formatter)} -> ${formatValue(change?.to, field, formatter)}`;
 }
 export function summarizeTaskEvent(event, formatter) {
     const changes = event.details?.changes || {};

package/dist/utils/taskActivity.test.js CHANGED Viewed

@@ -1,6 +1,33 @@
 import { describe, expect, it } from 'vitest';
 import { summarizeTaskChange } from './taskActivity';
 describe('summarizeTaskChange', () => {
+    it('summarizes title edits without dumping before and after text', () => {
+        expect(summarizeTaskChange('title', {
+            from: 'Old title',
+            to: 'New title',
+        })).toBe('TITLE: updated');
+    });
+    it('summarizes assignee changes with uppercase labels and formatted values', () => {
+        expect(summarizeTaskChange('assignee', { from: 'unassigned', to: 'member-1' }, (_field, value) => {
+            if (value === 'unassigned')
+                return 'Unassigned';
+            if (value === 'member-1')
+                return 'Emma Peel';
+            return undefined;
+        })).toBe('ASSIGNED TO: Unassigned -> Emma Peel');
+    });
+    it('summarizes description additions without rendering the body text', () => {
+        expect(summarizeTaskChange('description', {
+            from: '',
+            to: 'Line one\n\nLine two',
+        })).toBe('DESCRIPTION: added');
+    });
+    it('summarizes description clears without rendering the old body text', () => {
+        expect(summarizeTaskChange('description', {
+            from: 'Old body',
+            to: '',
+        })).toBe('DESCRIPTION: cleared');
+    });
     it('summarizes checklist completion clearly', () => {
         expect(summarizeTaskChange('checklistItems', {
             from: [{ id: 'a', title: 'First item', isCompleted: false, order: 0 }],

package/dist/utils/taskNormalization.js CHANGED Viewed

@@ -1,5 +1,5 @@
 import { cloneDefaultPriorityDefinitions } from '../shared/taxonomyDefaults.js';
-import { formatTaskReference } from './taskReferences.js';
+import { formatLocalTaskReference, formatTaskReference } from './taskReferences.js';
 export const DEFAULT_PRIORITY_DEFINITIONS = cloneDefaultPriorityDefinitions();
 const PRIORITY_VALUE_BY_LABEL = {
     low: 1,
@@ -75,12 +75,20 @@ export function normalizeTaskFromApi(task) {
         : Number.isFinite(Number(task.referenceNumber))
             ? Number(task.referenceNumber)
             : null;
+    const localReferenceNumber = typeof task.localReferenceNumber === 'number'
+        ? task.localReferenceNumber
+        : Number.isFinite(Number(task.localReferenceNumber))
+            ? Number(task.localReferenceNumber)
+            : null;
     return {
         ...task,
         referenceNumber: referenceNumber && referenceNumber > 0 ? Math.floor(referenceNumber) : null,
+        localReferenceNumber: localReferenceNumber && localReferenceNumber > 0 ? Math.floor(localReferenceNumber) : null,
         referenceLabel: typeof task.referenceLabel === 'string' && task.referenceLabel.trim().length > 0
             ? task.referenceLabel.trim()
-            : formatTaskReference(referenceNumber),
+            : (referenceNumber
+                ? formatTaskReference(referenceNumber)
+                : formatLocalTaskReference(localReferenceNumber)),
         assignee: (() => {
             const raw = String(task.assignee || '').trim();
             const normalized = raw.toLowerCase();

package/dist/utils/taskReferences.d.ts CHANGED Viewed

@@ -1,5 +1,15 @@
 import type { TaskItem } from '../types';
 export declare const TASK_REFERENCE_PREFIX = "T-";
+export declare const LOCAL_TASK_REFERENCE_PREFIX = "LT-";
+export interface TaskReferenceDisplayState {
+    label: string;
+    isProvisional: boolean;
+}
 export declare function formatTaskReference(value: number | Pick<TaskItem, 'referenceNumber'> | null | undefined): string;
+export declare function formatLocalTaskReference(value: number | Pick<TaskItem, 'localReferenceNumber'> | null | undefined): string;
 export declare function parseTaskReference(value: string | null | undefined): number | null;
-export declare function getTaskReferenceLabel(task: Pick<TaskItem, 'referenceNumber' | 'referenceLabel'> | null | undefined): string;
+export declare function parseLocalTaskReference(value: string | null | undefined): number | null;
+export declare function getTaskReferenceLabel(task: Pick<TaskItem, 'referenceNumber' | 'referenceLabel' | 'localReferenceNumber'> | null | undefined): string;
+export declare function isTaskReferenceProvisional(task: Pick<TaskItem, 'referenceNumber' | 'localReferenceNumber'> | null | undefined): boolean;
+export declare function getTaskReferenceDisplayState(task: Pick<TaskItem, 'referenceNumber' | 'referenceLabel' | 'localReferenceNumber'> | null | undefined): TaskReferenceDisplayState;
+export declare function shouldUseProvisionalTaskReferences(runtimeMode: string | null | undefined): boolean;

package/dist/utils/taskReferences.js CHANGED Viewed

@@ -1,11 +1,43 @@
 import { formatEntityReference, getEntityReferenceLabel, parseEntityReference, } from './entityReferences.js';
 export const TASK_REFERENCE_PREFIX = 'T-';
+export const LOCAL_TASK_REFERENCE_PREFIX = 'LT-';
 export function formatTaskReference(value) {
     return formatEntityReference(TASK_REFERENCE_PREFIX, value);
 }
+export function formatLocalTaskReference(value) {
+    if (typeof value === 'number' || value === null || value === undefined) {
+        return formatEntityReference(LOCAL_TASK_REFERENCE_PREFIX, value);
+    }
+    return formatEntityReference(LOCAL_TASK_REFERENCE_PREFIX, {
+        referenceNumber: value.localReferenceNumber ?? null
+    });
+}
 export function parseTaskReference(value) {
     return parseEntityReference(TASK_REFERENCE_PREFIX, value);
 }
+export function parseLocalTaskReference(value) {
+    return parseEntityReference(LOCAL_TASK_REFERENCE_PREFIX, value);
+}
 export function getTaskReferenceLabel(task) {
-    return getEntityReferenceLabel(TASK_REFERENCE_PREFIX, task);
+    if (!task)
+        return '';
+    if (typeof task.referenceLabel === 'string' && task.referenceLabel.trim().length > 0) {
+        return task.referenceLabel.trim();
+    }
+    const canonicalLabel = getEntityReferenceLabel(TASK_REFERENCE_PREFIX, task);
+    if (canonicalLabel)
+        return canonicalLabel;
+    return formatLocalTaskReference(task.localReferenceNumber);
+}
+export function isTaskReferenceProvisional(task) {
+    return !task?.referenceNumber && !!task?.localReferenceNumber;
+}
+export function getTaskReferenceDisplayState(task) {
+    return {
+        label: getTaskReferenceLabel(task),
+        isProvisional: isTaskReferenceProvisional(task)
+    };
+}
+export function shouldUseProvisionalTaskReferences(runtimeMode) {
+    return String(runtimeMode || '').trim().toLowerCase() === 'local';
 }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@taskforcehq/taskforce",
-  "version": "0.3.301",
+  "version": "0.3.303",
   "description": "Mission Command center for AI-powered task management (beta - under active development)",
   "author": "Taskforce HQ <hello@taskforcehq.ai> (https://taskforcehq.ai)",
   "license": "MIT",
@@ -37,6 +37,8 @@
     "perf": "sh scripts/run-dev-proxy.sh performance",
     "stage": "sh scripts/run-dev-proxy.sh staging",
     "prod": "TASKFORCE_RUNTIME_MODE=local TASKFORCE_CLOUD_ENVIRONMENT=production TASKFORCE_CLOUD_PROXY_BASE_URL=https://app.taskforcehq.ai VITE_TASKFORCE_BASE_URL=https://app.taskforcehq.ai npm run dev:runtime",
+    "deploy:staging": "bash scripts/deploy-staging.sh",
+    "deploy:prod": "bash scripts/deploy-prod.sh",
     "dev:runtime": "concurrently \"npm run dev:app\" \"TASKFORCE_RUNTIME_MODE=local sh scripts/with-esbuild.sh node --import tsx src/cli.ts open 5174\"",
     "stage:direct": "TASKFORCE_RUNTIME_MODE=local TASKFORCE_CLOUD_ENVIRONMENT=staging TASKFORCE_CLOUD_PROXY_BASE_URL=https://staging-app.taskforcehq.ai VITE_TASKFORCE_BASE_URL=https://staging-app.taskforcehq.ai npm run dev:runtime",
     "perf:direct": "TASKFORCE_RUNTIME_MODE=local TASKFORCE_CLOUD_ENVIRONMENT=performance TASKFORCE_CLOUD_PROXY_BASE_URL=https://performance-app.taskforcehq.ai VITE_TASKFORCE_BASE_URL=https://performance-app.taskforcehq.ai npm run dev:runtime",
@@ -60,8 +62,6 @@
     "check:localization-strings": "node scripts/check-localization-strings.mjs",
     "version:next": "node scripts/release-version.mjs --dry-run",
     "version:bump": "node scripts/release-version.mjs",
-    "deploy:staging": "bash scripts/deploy-staging.sh",
-    "deploy:prod": "bash scripts/deploy-prod.sh",
     "test:localization": "vitest run src/__tests__/localizationCatalogs.test.ts",
     "check:runtime-boundaries": "node scripts/check-runtime-boundaries.mjs",
     "test:workflow-readiness": "npm run check:workflows && vitest src/__tests__/workflowSimulation.test.ts src/__tests__/workflowExportMatrix.test.ts src/__tests__/workflowExportSnapshots.test.ts src/__tests__/workflowDocumentFixtures.test.ts src/__tests__/structuredCommentValidation.test.ts src/__tests__/structuredDocValidation.test.ts src/__tests__/workflowV2Policy.test.ts src/__tests__/workflowGeneration.test.ts src/__tests__/templates.test.ts",
@@ -78,6 +78,7 @@
     "test:e2e:realtime:reconnect": "npm run test:e2e:realtime -- tests/e2e/realtime-reconnect.spec.ts",
     "playwright:auth:bootstrap": "node scripts/bootstrap-playwright-auth.mjs",
     "playwright:auth": "sh scripts/playwright-auth.sh",
+    "qa:open": "node scripts/qa-open.mjs",
     "check:env": "node --import tsx scripts/check-env.ts --target=server --strict=true",
     "check:env:soak": "node --import tsx scripts/check-env.ts --target=soak --strict=true",
     "check:compat": "node scripts/check-compat-boundaries.mjs",

package/scripts/qa-open-lib.mjs ADDED Viewed

@@ -0,0 +1,175 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+export const QA_MODES = ['local', 'performance', 'staging'];
+export const QA_CLOUD_BASE_URLS = {
+    performance: 'https://performance-app.taskforcehq.ai',
+    staging: 'https://staging-app.taskforcehq.ai'
+};
+function normalizePort(raw) {
+    const value = String(raw || '').trim();
+    if (!value) return null;
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        return null;
+    }
+    return parsed;
+}
+function stripQuotes(raw) {
+    const value = String(raw || '').trim();
+    if (
+        (value.startsWith('"') && value.endsWith('"'))
+        || (value.startsWith("'") && value.endsWith("'"))
+    ) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+export function normalizeQaMode(raw) {
+    const normalized = String(raw || '').trim().toLowerCase();
+    return QA_MODES.includes(normalized) ? normalized : null;
+}
+export function sanitizeQaAgentId(raw) {
+    const normalized = String(raw || '')
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .replace(/-{2,}/g, '-');
+    return normalized || null;
+}
+export function parseQaArgs(argv, env = process.env) {
+    const positional = (argv || []).filter((arg) => !String(arg || '').startsWith('--'));
+    const mode = normalizeQaMode(positional[0] || env.TASKFORCE_QA_MODE || 'local');
+    const preferredPort = normalizePort(positional[1] || env.TASKFORCE_QA_PORT);
+    const agentId = sanitizeQaAgentId(env.TASKFORCE_QA_AGENT);
+    return { mode, agentId, preferredPort };
+}
+export function resolveQaPaths({ agentId, homeDir = os.homedir() }) {
+    const safeAgentId = sanitizeQaAgentId(agentId);
+    if (!safeAgentId) {
+        throw new Error('TASKFORCE_QA_AGENT is required and must contain at least one safe path character.');
+    }
+    const root = path.resolve(homeDir, '.taskforce', 'qa', safeAgentId);
+    return {
+        agentId: safeAgentId,
+        root,
+        projectRoot: path.join(root, 'project'),
+        envFile: path.join(root, 'env'),
+        logsDir: path.join(root, 'logs'),
+        artifactsDir: path.join(root, 'artifacts'),
+        homeDir: path.join(root, 'home'),
+        playwrightStorageState: path.join(root, 'playwright-auth.json')
+    };
+}
+export function isPathInside(parentPath, childPath) {
+    const parent = path.resolve(parentPath);
+    const child = path.resolve(childPath);
+    const relative = path.relative(parent, child);
+    return relative === '' || (!relative.startsWith('..') && !path.isAbsolute(relative));
+}
+export function assertQaProjectRootSafe(projectRoot, repoRoot) {
+    if (isPathInside(repoRoot, projectRoot)) {
+        throw new Error(
+            `Refusing to use QA project root inside the repository: ${projectRoot}\n`
+            + `Move the QA root outside ${repoRoot}.`
+        );
+    }
+}
+export function parseEnvFileContents(raw) {
+    const env = {};
+    const lines = String(raw || '').split(/\r?\n/);
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#')) continue;
+        const normalized = trimmed.startsWith('export ') ? trimmed.slice(7).trim() : trimmed;
+        const separatorIndex = normalized.indexOf('=');
+        if (separatorIndex <= 0) continue;
+        const key = normalized.slice(0, separatorIndex).trim();
+        if (!key) continue;
+        const value = normalized.slice(separatorIndex + 1);
+        env[key] = stripQuotes(value);
+    }
+    return env;
+}
+export function loadEnvFile(filePath) {
+    const raw = fs.readFileSync(filePath, 'utf8');
+    return parseEnvFileContents(raw);
+}
+export function ensureQaRootStructure(paths, options = {}) {
+    const projectName = String(options.projectName || `taskforce-qa-${paths.agentId}`).trim();
+    fs.mkdirSync(paths.root, { recursive: true });
+    fs.mkdirSync(paths.projectRoot, { recursive: true });
+    fs.mkdirSync(paths.logsDir, { recursive: true });
+    fs.mkdirSync(paths.artifactsDir, { recursive: true });
+    fs.mkdirSync(paths.homeDir, { recursive: true });
+    const packageJsonPath = path.join(paths.projectRoot, 'package.json');
+    if (!fs.existsSync(packageJsonPath)) {
+        fs.writeFileSync(packageJsonPath, JSON.stringify({ name: projectName }, null, 2) + '\n', 'utf8');
+    }
+    return packageJsonPath;
+}
+export function resolveExpectedWorkspace(env) {
+    const workspaceId = String(env.TASKFORCE_QA_EXPECTED_WORKSPACE_ID || '').trim();
+    const workspaceSlug = String(env.TASKFORCE_QA_EXPECTED_WORKSPACE_SLUG || '').trim();
+    if (!workspaceId && !workspaceSlug) return null;
+    return {
+        workspaceId: workspaceId || null,
+        workspaceSlug: workspaceSlug || null
+    };
+}
+export function matchExpectedWorkspace(result, expected) {
+    const nestedWorkspaces = Array.isArray(result?.workspaces?.workspaces) ? result.workspaces.workspaces : [];
+    const workspaces = Array.isArray(result?.workspaces) ? result.workspaces : nestedWorkspaces;
+    const currentWorkspaceId = String(result?.currentWorkspaceId || '').trim();
+    if (!expected) {
+        return {
+            ok: true,
+            matchedWorkspaceId: currentWorkspaceId || null,
+            reason: 'No expected workspace configured.'
+        };
+    }
+    if (expected.workspaceId) {
+        return {
+            ok: currentWorkspaceId === expected.workspaceId,
+            matchedWorkspaceId: currentWorkspaceId || null,
+            reason: currentWorkspaceId === expected.workspaceId
+                ? 'Matched expected workspace id.'
+                : `Expected workspace id ${expected.workspaceId} but current workspace id was ${currentWorkspaceId || '(empty)'}.`
+        };
+    }
+    const matchedBySlug = workspaces.find((workspace) => String(workspace?.slug || '').trim() === expected.workspaceSlug);
+    if (!matchedBySlug) {
+        return {
+            ok: false,
+            matchedWorkspaceId: currentWorkspaceId || null,
+            reason: `Expected workspace slug ${expected.workspaceSlug} was not present in the available workspaces list.`
+        };
+    }
+    return {
+        ok: currentWorkspaceId === String(matchedBySlug.id || '').trim(),
+        matchedWorkspaceId: currentWorkspaceId || null,
+        reason: currentWorkspaceId === String(matchedBySlug.id || '').trim()
+            ? 'Matched expected workspace slug.'
+            : `Expected workspace slug ${expected.workspaceSlug} to resolve to workspace id ${String(matchedBySlug.id || '').trim()}, but current workspace id was ${currentWorkspaceId || '(empty)'}.`
+    };
+}

package/scripts/qa-open-lib.mjs.d.ts ADDED Viewed

@@ -0,0 +1,49 @@
+export const QA_MODES: string[];
+export const QA_CLOUD_BASE_URLS: Record<string, string>;
+export function normalizeQaMode(raw: unknown): string | null;
+export function sanitizeQaAgentId(raw: unknown): string | null;
+export function parseQaArgs(
+    argv?: string[],
+    env?: Record<string, string | undefined>
+): { mode: string | null; agentId: string | null; preferredPort: number | null };
+export function resolveQaPaths(input: {
+    agentId: string;
+    homeDir?: string;
+}): {
+    agentId: string;
+    root: string;
+    projectRoot: string;
+    envFile: string;
+    logsDir: string;
+    artifactsDir: string;
+    homeDir: string;
+    playwrightStorageState: string;
+};
+export function isPathInside(parentPath: string, childPath: string): boolean;
+export function assertQaProjectRootSafe(projectRoot: string, repoRoot: string): void;
+export function parseEnvFileContents(raw: unknown): Record<string, string>;
+export function loadEnvFile(filePath: string): Record<string, string>;
+export function ensureQaRootStructure(
+    paths: {
+        agentId: string;
+        root: string;
+        projectRoot: string;
+        logsDir: string;
+        artifactsDir: string;
+        homeDir: string;
+    },
+    options?: { projectName?: string }
+): string;
+export function resolveExpectedWorkspace(env: Record<string, string | undefined>): {
+    workspaceId: string | null;
+    workspaceSlug: string | null;
+} | null;
+export function matchExpectedWorkspace(
+    result: unknown,
+    expected: { workspaceId: string | null; workspaceSlug: string | null } | null
+): {
+    ok: boolean;
+    matchedWorkspaceId: string | null;
+    reason: string;
+};