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

@taskforcehq/taskforce 0.3.301 → 0.3.302

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 (147) hide show

package/dist/Taskforce.module.css +26 -2
package/dist/TaskforceCore.filter-persistence.test.js +1 -1
package/dist/TaskforceCore.js +13 -24
package/dist/TaskforceCore.test.js +167 -152
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/ui/ReferenceBadgeButton.js +1 -1
package/dist/components/views/PlansPage.js +9 -8
package/dist/components/views/StandaloneLayout.js +466 -204
package/dist/components/views/panels/PlanningDrawer.js +18 -1
package/dist/components/views/standalone/modals/AccountHubModal.d.ts +43 -0
package/dist/components/views/standalone/modals/AccountHubModal.js +22 -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/SyncReconciliationService.d.ts +2 -0
package/dist/core/SyncReconciliationService.js +3 -0
package/dist/core/TaskAuditTimeline.test.js +40 -0
package/dist/core/Taskforce.d.ts +49 -0
package/dist/core/Taskforce.ids.test.js +133 -0
package/dist/core/Taskforce.js +241 -78
package/dist/core/UserProfileAvatarDrafts.test.d.ts +1 -0
package/dist/core/UserProfileAvatarDrafts.test.js +102 -0
package/dist/core/taskReferencePolicy.d.ts +28 -0
package/dist/core/taskReferencePolicy.js +189 -0
package/dist/core/types.d.ts +2 -0
package/dist/hooks/tasks/useTaskFormActions.js +3 -0
package/dist/hooks/useTaskData.js +3 -2
package/dist/hooks/useTaskData.test.js +66 -0
package/dist/hooks/useTaskforce.d.ts +5 -0
package/dist/hooks/useTaskforce.js +63 -15
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 +41 -19
package/dist/mcp/runtime.test.js +49 -2
package/dist/migrations/taskSchemaMigrations.js +53 -1
package/dist/qaOpen.test.d.ts +1 -0
package/dist/qaOpen.test.js +56 -0
package/dist/server/index.cookieProxy.test.js +1 -0
package/dist/server/index.d.ts +1 -0
package/dist/server/index.js +15 -1
package/dist/server/index.test.js +14 -1
package/dist/server/routes/admin.js +25 -22
package/dist/server/routes/auth.d.ts +5 -0
package/dist/server/routes/auth.js +350 -16
package/dist/server/routes/billing.js +11 -1
package/dist/server/routes/billing.test.js +32 -2
package/dist/server/routes/documents.js +6 -1
package/dist/server/routes/shared.d.ts +1 -1
package/dist/server/routes/shared.js +11 -3
package/dist/server/routes/sync.integration.test.js +130 -0
package/dist/server/routes/sync.js +226 -1924
package/dist/server/routes/tasks.js +18 -4
package/dist/server/routes.js +26 -19
package/dist/server/routes.test.js +352 -6
package/dist/shared/runtimeContract.d.ts +1 -1
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 +88 -0
package/dist/sync/contentSyncState.js +743 -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/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 +28 -0
package/dist/sync/workspacePullFeed.js +301 -0
package/dist/sync/workspacePullFeed.test.d.ts +1 -0
package/dist/sync/workspacePullFeed.test.js +166 -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-JG5jc3he.js} +1 -1
package/dist/ui/assets/{AnnotatedAttachmentWorkspace-jKUVo-PJ.js → AnnotatedAttachmentWorkspace-Dvi02Y7q.js} +1 -1
package/dist/ui/assets/{DocumentWorkspace-DuQa-uIC.js → DocumentWorkspace-iys3zfca.js} +2 -2
package/dist/ui/assets/{InitiativesModule-C8Pi2VTk.js → InitiativesModule-DJvLJI3A.js} +1 -1
package/dist/ui/assets/PlansPage-BMPlpFpw.js +1 -0
package/dist/ui/assets/TaskSettings-Bqd4cCzW.js +8 -0
package/dist/ui/assets/{TaskSettings-BwB9NtmJ.css → TaskSettings-CnIBL_Eb.css} +1 -1
package/dist/ui/assets/{WorkflowsModule-b6TLuHwJ.js → WorkflowsModule-BguHeQaV.js} +1 -1
package/dist/ui/assets/index-MXeWoebC.css +1 -0
package/dist/ui/assets/index-YJ4k5QNa.js +6 -0
package/dist/ui/assets/{vendor-icons-QZyhEwgT.js → vendor-icons-C8EED3Oh.js} +1 -1
package/dist/ui/index.html +3 -3
package/dist/utils/billingStatusCache.d.ts +21 -0
package/dist/utils/billingStatusCache.js +70 -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 +2 -1
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-YJ4k5QNa.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-C8EED3Oh.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-MXeWoebC.css">
   </head>
   <body>
     <div id="root"></div>

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

@@ -0,0 +1,21 @@
+export type BillingStatusPayload = {
+    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;
+    planSelectionRequired?: boolean;
+};
+export declare function invalidateBillingStatusCache(rawUrl: string): void;
+export declare function loadBillingStatusCached(rawUrl: string, options?: {
+    force?: boolean;
+}): Promise<BillingStatusPayload | null>;

package/dist/utils/billingStatusCache.js ADDED Viewed

@@ -0,0 +1,70 @@
+import { logBootstrapDebug } from '../hooks/workspace/workspaceLocalState';
+const BILLING_STATUS_CACHE_TTL_MS = 5_000;
+const billingStatusCache = new Map();
+function getTimingNow() {
+    return typeof performance !== 'undefined' ? performance.now() : Date.now();
+}
+function normalizeBillingStatusUrl(raw) {
+    return String(raw || '').trim();
+}
+export function invalidateBillingStatusCache(rawUrl) {
+    billingStatusCache.delete(normalizeBillingStatusUrl(rawUrl));
+}
+export async function loadBillingStatusCached(rawUrl, options) {
+    const url = normalizeBillingStatusUrl(rawUrl);
+    if (!url)
+        return null;
+    const force = options?.force === true;
+    const now = Date.now();
+    const cached = billingStatusCache.get(url);
+    if (!force && cached?.payload !== undefined && (now - cached.fetchedAt) < BILLING_STATUS_CACHE_TTL_MS) {
+        logBootstrapDebug('billing_status_cache_hit', {
+            url,
+            ageMs: now - cached.fetchedAt
+        });
+        return cached.payload;
+    }
+    if (!force && cached?.promise) {
+        logBootstrapDebug('billing_status_request_reused', {
+            url
+        });
+        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 billing status.'));
+        }
+        const payload = await res.json().catch(() => ({}));
+        const normalized = (payload || null);
+        billingStatusCache.set(url, {
+            payload: normalized,
+            fetchedAt: Date.now(),
+            promise: null
+        });
+        logBootstrapDebug('billing_status_loaded', {
+            url,
+            durationMs: Math.round(getTimingNow() - startedAt),
+            fromCache: false
+        });
+        return normalized;
+    })().catch((error) => {
+        billingStatusCache.delete(url);
+        logBootstrapDebug('billing_status_failed', {
+            url,
+            durationMs: Math.round(getTimingNow() - startedAt),
+            error: error instanceof Error ? error.message : String(error || 'Unknown error')
+        });
+        throw error;
+    });
+    billingStatusCache.set(url, {
+        payload: cached?.payload ?? null,
+        fetchedAt: cached?.fetchedAt ?? 0,
+        promise: request
+    });
+    return request;
+}

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.302",
   "description": "Mission Command center for AI-powered task management (beta - under active development)",
   "author": "Taskforce HQ <hello@taskforcehq.ai> (https://taskforcehq.ai)",
   "license": "MIT",
@@ -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;
+};