@taskforcehq/taskforce 0.3.313 → 0.3.315

package/dist/compat/workspaceSyncCompat.js

@@ -93,6 +93,7 @@ export function normalizeWorkspaceSyncStateCompat(rawState) {
         enabled: Boolean(state.enabled ?? state.cloudSyncEnabled),
         phase: 'idle',
         setupIntent: normalizeSetupIntent(state.setupIntent),
+        startupFullReconcileCompletedAt: normalizeTimestamp(state.startupFullReconcileCompletedAt),
         pullCursor: normalizeTimestamp(state.pullCursor),
         lastPullAt: normalizeTimestamp(state.lastPullAt),
         lastPushAt: normalizeTimestamp(state.lastPushAt),
@@ -116,6 +117,7 @@ export function normalizeWorkspaceSyncStateCompat(rawState) {
         || Boolean(state.enabled ?? state.cloudSyncEnabled) !== normalized.enabled
         || String(state.phase || '').trim() !== normalized.phase
         || normalizeSetupIntent(state.setupIntent) !== normalized.setupIntent
+        || normalizeTimestamp(state.startupFullReconcileCompletedAt) !== normalized.startupFullReconcileCompletedAt
         || normalizeTimestamp(state.pullCursor) !== normalized.pullCursor
         || normalizeTimestamp(state.lastPullAt) !== normalized.lastPullAt
         || normalizeTimestamp(state.lastPushAt) !== normalized.lastPushAt

package/dist/components/features/AnnotatedAttachmentWorkspace.js

@@ -118,6 +118,14 @@ function isEditableKeyboardTarget(target) {
         return true;
     return tagName === 'input' || tagName === 'textarea' || tagName === 'select';
 }
+function isInteractiveKeyboardTarget(target) {
+    if (!(target instanceof HTMLElement))
+        return false;
+    if (isEditableKeyboardTarget(target))
+        return true;
+    const tagName = target.tagName.toLowerCase();
+    return tagName === 'button' || tagName === 'a' || target.getAttribute('role') === 'button';
+}
 function normalizeOrder(annotations) {
     return annotations.map((annotation, index) => ({
         ...annotation,
@@ -438,6 +446,7 @@ export function AnnotatedAttachmentWorkspaceShell({ runtimeMode = 'local', apiBa
     const [imageLoadError, setImageLoadError] = useState(false);
     const [zoomLevel, setZoomLevel] = useState(1);
     const [panMode, setPanMode] = useState(false);
+    const [spacePanActive, setSpacePanActive] = useState(false);
     const [pastingImage, setPastingImage] = useState(false);
     const [naturalImageSize, setNaturalImageSize] = useState({ width: 0, height: 0 });
     const overlayRef = useRef(null);
@@ -542,6 +551,7 @@ export function AnnotatedAttachmentWorkspaceShell({ runtimeMode = 'local', apiBa
                 || canvasMediaSize.height > (scroller.clientHeight + 1)));
     }, [canvasMediaSize.height, canvasMediaSize.width, zoomLevel]);
     const zoomLabel = `${Math.round(zoomLevel * 100)}%`;
+    const isPanActive = canPan && (panMode || spacePanActive);
     const annotationOrderNumbers = useMemo(() => {
         const orderMap = new Map();
         draftAnnotations.forEach((annotation, index) => {
@@ -1232,6 +1242,7 @@ export function AnnotatedAttachmentWorkspaceShell({ runtimeMode = 'local', apiBa
         setNaturalImageSize({ width: 0, height: 0 });
         setZoomLevel(1);
         setPanMode(false);
+        setSpacePanActive(false);
     }, [activeTarget?.path]);
     useEffect(() => {
         if (!imageLoading)
@@ -1250,6 +1261,7 @@ export function AnnotatedAttachmentWorkspaceShell({ runtimeMode = 'local', apiBa
         if (canPan)
             return;
         setPanMode(false);
+        setSpacePanActive(false);
     }, [canPan]);
     useEffect(() => {
         setPayloadPreview(null);
@@ -1657,6 +1669,34 @@ export function AnnotatedAttachmentWorkspaceShell({ runtimeMode = 'local', apiBa
         window.addEventListener('keydown', handleKeyDown);
         return () => window.removeEventListener('keydown', handleKeyDown);
     }, [deleteSelectedAnnotation, selectedAnnotationId]);
+    useEffect(() => {
+        const handleKeyDown = (event) => {
+            if (event.code !== 'Space')
+                return;
+            if (!canPan)
+                return;
+            if (isInteractiveKeyboardTarget(event.target))
+                return;
+            event.preventDefault();
+            setSpacePanActive(true);
+        };
+        const handleKeyUp = (event) => {
+            if (event.code !== 'Space')
+                return;
+            setSpacePanActive(false);
+        };
+        const handleWindowBlur = () => {
+            setSpacePanActive(false);
+        };
+        window.addEventListener('keydown', handleKeyDown);
+        window.addEventListener('keyup', handleKeyUp);
+        window.addEventListener('blur', handleWindowBlur);
+        return () => {
+            window.removeEventListener('keydown', handleKeyDown);
+            window.removeEventListener('keyup', handleKeyUp);
+            window.removeEventListener('blur', handleWindowBlur);
+        };
+    }, [canPan]);
     const readPoint = useCallback((event) => {
         const rect = overlayRef.current?.getBoundingClientRect();
         if (!rect || rect.width <= 0 || rect.height <= 0)
@@ -1667,7 +1707,7 @@ export function AnnotatedAttachmentWorkspaceShell({ runtimeMode = 'local', apiBa
         };
     }, []);
     const handleCanvasPointerDown = useCallback((event) => {
-        if (panMode && canPan) {
+        if (isPanActive) {
             const scroller = canvasScrollerRef.current;
             if (!scroller)
                 return;
@@ -1709,7 +1749,7 @@ export function AnnotatedAttachmentWorkspaceShell({ runtimeMode = 'local', apiBa
         setDraftAnnotations((current) => normalizeOrder([...current, annotation]));
         setSelectedAnnotationId(annotation.id);
         markDraftChanged(300);
-    }, [canPan, defaultMarkerColor, markDraftChanged, panMode, readPoint, selectedSessionId, toolMode]);
+    }, [defaultMarkerColor, isPanActive, markDraftChanged, readPoint, selectedSessionId, toolMode]);
     const handleCanvasPointerUp = useCallback((event) => {
         if (panRef.current?.pointerId === event.pointerId) {
             event.currentTarget.releasePointerCapture?.(event.pointerId);
@@ -1726,7 +1766,7 @@ export function AnnotatedAttachmentWorkspaceShell({ runtimeMode = 'local', apiBa
         setToolMode('select');
     }, [readPoint, toolMode]);
     const startDragAnnotation = useCallback((event, annotation) => {
-        if (toolMode !== 'select' || panMode)
+        if (toolMode !== 'select' || isPanActive)
             return;
         const point = readPoint(event);
         if (!point)
@@ -1738,7 +1778,7 @@ export function AnnotatedAttachmentWorkspaceShell({ runtimeMode = 'local', apiBa
         };
         setSelectedAnnotationId(annotation.id);
         event.stopPropagation();
-    }, [panMode, readPoint, toolMode]);
+    }, [isPanActive, readPoint, toolMode]);
     const handleCanvasPointerMove = useCallback((event) => {
         if (panRef.current?.pointerId === event.pointerId) {
             const scroller = canvasScrollerRef.current;
@@ -1872,7 +1912,7 @@ export function AnnotatedAttachmentWorkspaceShell({ runtimeMode = 'local', apiBa
         panRef.current = null;
     }, []);
     const startResizeBox = useCallback((event, annotation) => {
-        if (toolMode !== 'select' || panMode)
+        if (toolMode !== 'select' || isPanActive)
             return;
         const point = readPoint(event);
         if (!point)
@@ -1884,9 +1924,9 @@ export function AnnotatedAttachmentWorkspaceShell({ runtimeMode = 'local', apiBa
         };
         setSelectedAnnotationId(annotation.id);
         event.stopPropagation();
-    }, [panMode, readPoint, toolMode]);
+    }, [isPanActive, readPoint, toolMode]);
     const startArrowHandleDrag = useCallback((event, annotation, endpoint) => {
-        if (toolMode !== 'select' || panMode)
+        if (toolMode !== 'select' || isPanActive)
             return;
         const point = readPoint(event);
         if (!point)
@@ -1899,7 +1939,7 @@ export function AnnotatedAttachmentWorkspaceShell({ runtimeMode = 'local', apiBa
         };
         setSelectedAnnotationId(annotation.id);
         event.stopPropagation();
-    }, [panMode, readPoint, toolMode]);
+    }, [isPanActive, readPoint, toolMode]);
     const activeSessionTimestamp = selectedSession?.updatedAt ? formatTimestamp(selectedSession.updatedAt) : 'Not saved yet';
     return (_jsxs("div", { className: `${styles.shell} ${showImageTray ? styles.shellWithImageTray : ''} ${showImageTray && imageTrayOpen ? styles.shellImageTrayOpen : ''}`.trim(), children: [showImageTray ? (_jsxs("aside", { className: `${styles.imageTrayPanel} ${imageTrayOpen ? styles.imageTrayPanelOpen : ''}`.trim(), "aria-label": "Image tray", "aria-hidden": !imageTrayOpen, children: [_jsxs("div", { className: styles.imageTrayHeader, children: [_jsxs("span", { className: styles.imageTrayTitle, children: [_jsx(FolderOpen, { size: 14 }), "Images"] }), _jsx("button", { type: "button", className: "tf-control-icon", onClick: onCloseImageTray, title: "Collapse image tray", "aria-label": "Collapse image tray", children: _jsx(ChevronLeft, { size: 16 }) })] }), _jsxs("div", { className: styles.imageTraySearch, children: [_jsx(Search, { size: 12, className: styles.imageTraySearchIcon }), _jsx("input", { type: "text", placeholder: "Search images...", value: imageTraySearchQuery, onChange: (event) => setImageTraySearchQuery(event.target.value), className: styles.imageTraySearchInput })] }), _jsx("div", { className: `tf-scrollbar ${styles.imageTrayList}`, children: imageTrayLoading ? (_jsx("div", { className: styles.imageTrayState, children: "Loading images..." })) : imageTrayError ? (_jsx("div", { className: styles.imageTrayStateError, children: imageTrayError })) : filteredImageTrayItems.length === 0 ? (_jsx("div", { className: styles.imageTrayState, children: imageTraySearchQuery.trim() ? 'No images match your search.' : 'No images found.' })) : filteredImageTrayItems.map((item) => {
                             const isSelected = activeTarget?.assetId === item.assetId;
@@ -1957,7 +1997,7 @@ export function AnnotatedAttachmentWorkspaceShell({ runtimeMode = 'local', apiBa
                                             if (!selectedSession)
                                                 return;
                                             restoreLastSavedDraft();
-                                        }, disabled: !selectedSession || !hasUnsavedChanges, "aria-label": "Reset unsaved changes", title: "Reset unsaved changes", children: _jsx(RotateCcw, { size: 18 }) }), _jsx("button", { type: "button", className: `tf-button-ghost ${styles.toolRailButton} ${styles.iconButton}`, onClick: zoomOut, disabled: !activeTarget || imageLoading || zoomLevel <= 0.25, "aria-label": "Zoom out", children: _jsx(ZoomOut, { size: 18 }) }), _jsx("button", { type: "button", className: `tf-button-ghost tf-button-compact ${styles.ghostBtn} ${styles.toolbarButton}`, onClick: resetZoom, disabled: !activeTarget || imageLoading || zoomLevel === 1, "aria-label": `Reset zoom to 100 percent (currently ${zoomLabel})`, title: `Reset zoom to 100% (currently ${zoomLabel})`, children: _jsx("span", { children: zoomLabel }) }), _jsx("button", { type: "button", className: `tf-button-ghost ${styles.toolRailButton} ${styles.iconButton}`, onClick: zoomIn, disabled: !activeTarget || imageLoading || zoomLevel >= 4, "aria-label": "Zoom in", children: _jsx(ZoomIn, { size: 18 }) }), _jsx("button", { type: "button", className: `tf-button-ghost tf-button-compact ${styles.toolBtn} ${styles.toolbarButton} ${panMode ? styles.toolBtnActive : ''}`, onClick: () => setPanMode((current) => !current), disabled: !activeTarget || imageLoading || !canPan, "aria-label": "Pan canvas", title: "Pan canvas", children: _jsx(Hand, { size: 18 }) })] }), _jsx("span", { className: styles.toolbarSeparator, "aria-hidden": "true" }), _jsxs("div", { className: styles.toolbarActions, children: [_jsx("div", { className: styles.toolbarSelectionActions, children: selectedAnnotation ? (_jsxs(_Fragment, { children: [_jsxs("div", { ref: colorPickerRef, className: styles.toolbarColorPicker, children: [_jsx("button", { type: "button", className: `tf-button-ghost tf-button-compact ${styles.ghostBtn} ${styles.toolbarButton} ${styles.colorPickerButton}`, onClick: () => setColorPickerOpen((current) => !current), "aria-label": "Marker color", "aria-expanded": colorPickerOpen, title: "Marker color", children: _jsx("span", { className: styles.colorPickerSwatch, style: { backgroundColor: selectedMarkerColor }, "aria-hidden": "true" }) }), colorPickerOpen ? (_jsx("div", { className: styles.colorPickerPopover, role: "menu", "aria-label": "Marker color options", children: MARKER_COLOR_SWATCHES.map((color) => (_jsx("button", { type: "button", className: `${styles.colorOption} ${selectedMarkerColor === color ? styles.colorOptionActive : ''}`, style: { backgroundColor: color }, onClick: () => applyMarkerColor(color), "aria-label": `Use marker color ${color}`, "aria-pressed": selectedMarkerColor === color }, color))) })) : null] }), _jsx("button", { type: "button", className: `tf-button-ghost tf-button-compact ${styles.ghostBtn} ${styles.toolbarButton}`, onClick: deleteSelectedAnnotation, "aria-label": "Delete marker", title: "Delete selected marker", children: _jsx(Trash2, { size: 18 }) }), _jsx("div", { className: styles.toolbarGeometryFields, "aria-label": "Marker geometry percent controls", children: getGeometryFields(selectedAnnotation).map((field) => (_jsxs("label", { className: styles.toolbarGeometryField, children: [_jsx("span", { className: `tf-text-meta ${styles.toolbarGeometryLabel}`, children: field.label }), _jsx("input", { className: `tf-field-shell ${styles.toolbarGeometryInput}`, type: "number", min: 0, max: 100, step: 0.1, value: field.value, onChange: (event) => {
+                                        }, disabled: !selectedSession || !hasUnsavedChanges, "aria-label": "Reset unsaved changes", title: "Reset unsaved changes", children: _jsx(RotateCcw, { size: 18 }) }), _jsx("button", { type: "button", className: `tf-button-ghost ${styles.toolRailButton} ${styles.iconButton}`, onClick: zoomOut, disabled: !activeTarget || imageLoading || zoomLevel <= 0.25, "aria-label": "Zoom out", children: _jsx(ZoomOut, { size: 18 }) }), _jsx("button", { type: "button", className: `tf-button-ghost tf-button-compact ${styles.ghostBtn} ${styles.toolbarButton}`, onClick: resetZoom, disabled: !activeTarget || imageLoading || zoomLevel === 1, "aria-label": `Reset zoom to 100 percent (currently ${zoomLabel})`, title: `Reset zoom to 100% (currently ${zoomLabel})`, children: _jsx("span", { children: zoomLabel }) }), _jsx("button", { type: "button", className: `tf-button-ghost ${styles.toolRailButton} ${styles.iconButton}`, onClick: zoomIn, disabled: !activeTarget || imageLoading || zoomLevel >= 4, "aria-label": "Zoom in", children: _jsx(ZoomIn, { size: 18 }) }), _jsx("button", { type: "button", className: `tf-button-ghost tf-button-compact ${styles.toolBtn} ${styles.toolbarButton} ${isPanActive ? styles.toolBtnActive : ''}`, onClick: () => setPanMode((current) => !current), disabled: !activeTarget || imageLoading || !canPan, "aria-label": "Pan canvas", title: "Pan canvas", children: _jsx(Hand, { size: 18 }) })] }), _jsx("span", { className: styles.toolbarSeparator, "aria-hidden": "true" }), _jsxs("div", { className: styles.toolbarActions, children: [_jsx("div", { className: styles.toolbarSelectionActions, children: selectedAnnotation ? (_jsxs(_Fragment, { children: [_jsxs("div", { ref: colorPickerRef, className: styles.toolbarColorPicker, children: [_jsx("button", { type: "button", className: `tf-button-ghost tf-button-compact ${styles.ghostBtn} ${styles.toolbarButton} ${styles.colorPickerButton}`, onClick: () => setColorPickerOpen((current) => !current), "aria-label": "Marker color", "aria-expanded": colorPickerOpen, title: "Marker color", children: _jsx("span", { className: styles.colorPickerSwatch, style: { backgroundColor: selectedMarkerColor }, "aria-hidden": "true" }) }), colorPickerOpen ? (_jsx("div", { className: styles.colorPickerPopover, role: "menu", "aria-label": "Marker color options", children: MARKER_COLOR_SWATCHES.map((color) => (_jsx("button", { type: "button", className: `${styles.colorOption} ${selectedMarkerColor === color ? styles.colorOptionActive : ''}`, style: { backgroundColor: color }, onClick: () => applyMarkerColor(color), "aria-label": `Use marker color ${color}`, "aria-pressed": selectedMarkerColor === color }, color))) })) : null] }), _jsx("button", { type: "button", className: `tf-button-ghost tf-button-compact ${styles.ghostBtn} ${styles.toolbarButton}`, onClick: deleteSelectedAnnotation, "aria-label": "Delete marker", title: "Delete selected marker", children: _jsx(Trash2, { size: 18 }) }), _jsx("div", { className: styles.toolbarGeometryFields, "aria-label": "Marker geometry percent controls", children: getGeometryFields(selectedAnnotation).map((field) => (_jsxs("label", { className: styles.toolbarGeometryField, children: [_jsx("span", { className: `tf-text-meta ${styles.toolbarGeometryLabel}`, children: field.label }), _jsx("input", { className: `tf-field-shell ${styles.toolbarGeometryInput}`, type: "number", min: 0, max: 100, step: 0.1, value: field.value, onChange: (event) => {
                                                                     const nextValue = parsePercentField(event.target.value);
                                                                     if (nextValue === null)
                                                                         return;
@@ -1980,7 +2020,7 @@ export function AnnotatedAttachmentWorkspaceShell({ runtimeMode = 'local', apiBa
                                                                 setNaturalImageSize({ width: 0, height: 0 });
                                                                 setImageLoading(false);
                                                                 setImageLoadError(true);
-                                                            } }), !imageLoading && !imageLoadError && selectedSession ? (_jsxs("div", { ref: overlayRef, className: `${styles.overlay} ${toolMode === 'select' ? styles.overlaySelect : ''} ${panMode && canPan ? styles.overlayPan : ''}`, onPointerDown: handleCanvasPointerDown, onPointerMove: handleCanvasPointerMove, onPointerUp: (event) => {
+                                                            } }), !imageLoading && !imageLoadError && selectedSession ? (_jsxs("div", { ref: overlayRef, className: `${styles.overlay} ${toolMode === 'select' ? styles.overlaySelect : ''} ${isPanActive ? styles.overlayPan : ''}`, onPointerDown: handleCanvasPointerDown, onPointerMove: handleCanvasPointerMove, onPointerUp: (event) => {
                                                                 handleCanvasPointerUp(event);
                                                                 handleCanvasPointerEnd();
                                                             }, "data-testid": "annotated-attachment-overlay", onPointerLeave: handleCanvasPointerLeave, onPointerCancel: handleCanvasPointerCancel, children: [_jsx("svg", { className: styles.overlaySvg, viewBox: arrowOverlayViewBox, preserveAspectRatio: "none", "aria-hidden": "true", children: draftAnnotations.filter((annotation) => annotation.kind === 'arrow').map((annotation) => {
@@ -2022,7 +2062,7 @@ export function AnnotatedAttachmentWorkspaceShell({ runtimeMode = 'local', apiBa
                                     ? 'Save failed. Retry now.'
                                     : saveState === 'saving' || saveState === 'pending'
                                         ? 'Saving…'
-                                        : 'Saved' }), error ? _jsx("span", { children: error }) : _jsx("span", { children: !selectedSession ? 'Create a session to begin placing markers on this image.' : panMode && canPan ? 'Drag on the image to pan.' : toolMode === 'select' ? 'Select a marker to edit it.' : `Click on the image to place a ${toolMode}.` }), activeTarget && !selectedSession && showCreateSessionPrompt ? (_jsx("button", { type: "button", className: `tf-button-ghost tf-button-compact ${styles.ghostBtn} ${styles.toolbarButton}`, onClick: () => void createSession(), disabled: saving || loading, children: saving ? 'Creating…' : 'Create one now' })) : null] })] }), _jsx("section", { className: `tf-surface-panel ${styles.panel} ${styles.detailPanel}`, children: selectedSession ? (_jsxs(_Fragment, { children: [_jsxs("div", { className: styles.panelHeader, children: [_jsxs("div", { className: styles.panelHeaderText, children: [_jsx("div", { className: `tf-heading-card ${styles.panelTitle}`, children: "Markers" }), _jsxs("div", { className: "tf-text-secondary", children: [draftAnnotations.length, " in this session"] })] }), _jsxs("div", { className: styles.sessionActions, children: [_jsx("button", { type: "button", className: `tf-control-icon ${styles.iconButton}`, onClick: () => moveSelectedAnnotation('up'), disabled: !selectedAnnotation || selectedAnnotationIndex <= 0, "aria-label": "Move marker up", children: _jsx(ArrowUp, { size: 16 }) }), _jsx("button", { type: "button", className: `tf-control-icon ${styles.iconButton}`, onClick: () => moveSelectedAnnotation('down'), disabled: !selectedAnnotation || selectedAnnotationIndex === -1 || selectedAnnotationIndex >= draftAnnotations.length - 1, "aria-label": "Move marker down", children: _jsx(ArrowDown, { size: 16 }) })] })] }), _jsx("div", { className: `tf-scrollbar ${styles.annotationList}`, children: draftAnnotations.length === 0 ? (_jsx("div", { className: styles.detailEmpty, children: _jsx("p", { className: "tf-empty-copy", children: "Add a marker on the image to begin." }) })) : draftAnnotations.map((annotation, index) => {
+                                        : 'Saved' }), error ? _jsx("span", { children: error }) : _jsx("span", { children: !selectedSession ? 'Create a session to begin placing markers on this image.' : isPanActive ? 'Drag on the image to pan.' : toolMode === 'select' ? 'Select a marker to edit it.' : `Click on the image to place a ${toolMode}.` }), activeTarget && !selectedSession && showCreateSessionPrompt ? (_jsx("button", { type: "button", className: `tf-button-ghost tf-button-compact ${styles.ghostBtn} ${styles.toolbarButton}`, onClick: () => void createSession(), disabled: saving || loading, children: saving ? 'Creating…' : 'Create one now' })) : null] })] }), _jsx("section", { className: `tf-surface-panel ${styles.panel} ${styles.detailPanel}`, children: selectedSession ? (_jsxs(_Fragment, { children: [_jsxs("div", { className: styles.panelHeader, children: [_jsxs("div", { className: styles.panelHeaderText, children: [_jsx("div", { className: `tf-heading-card ${styles.panelTitle}`, children: "Markers" }), _jsxs("div", { className: "tf-text-secondary", children: [draftAnnotations.length, " in this session"] })] }), _jsxs("div", { className: styles.sessionActions, children: [_jsx("button", { type: "button", className: `tf-control-icon ${styles.iconButton}`, onClick: () => moveSelectedAnnotation('up'), disabled: !selectedAnnotation || selectedAnnotationIndex <= 0, "aria-label": "Move marker up", children: _jsx(ArrowUp, { size: 16 }) }), _jsx("button", { type: "button", className: `tf-control-icon ${styles.iconButton}`, onClick: () => moveSelectedAnnotation('down'), disabled: !selectedAnnotation || selectedAnnotationIndex === -1 || selectedAnnotationIndex >= draftAnnotations.length - 1, "aria-label": "Move marker down", children: _jsx(ArrowDown, { size: 16 }) })] })] }), _jsx("div", { className: `tf-scrollbar ${styles.annotationList}`, children: draftAnnotations.length === 0 ? (_jsx("div", { className: styles.detailEmpty, children: _jsx("p", { className: "tf-empty-copy", children: "Add a marker on the image to begin." }) })) : draftAnnotations.map((annotation, index) => {
                                 const AnnotationKindIcon = ANNOTATION_KIND_ICON[annotation.kind];
                                 const annotationKindLabel = ANNOTATION_KIND_LABELS[annotation.kind];
                                 const annotationSequenceLabel = `${annotationKindLabel} ${index + 1}`;

package/dist/core/PlanEntitlementService.d.ts

@@ -184,6 +184,7 @@ export declare class PlanEntitlementService {
     createCustomPlanFeatureCatalogEntry(input: {
         label: string;
         description?: string | null;
+        publicVisible?: boolean | null;
         publicLabel?: string | null;
         publicDescription?: string | null;
         publicDescriptionVisible?: boolean | null;
@@ -194,6 +195,7 @@ export declare class PlanEntitlementService {
         featureKey: string;
         label?: string | null;
         description?: string | null;
+        publicVisible?: boolean | null;
         publicLabel?: string | null;
         publicDescription?: string | null;
         publicDescriptionVisible?: boolean | null;

package/dist/core/PlanEntitlementService.js

@@ -92,7 +92,7 @@ export class PlanEntitlementService {
     }
     listCustomPlanFeatureCatalogEntries() {
         const rows = this.db.prepare(`
-            SELECT feature_key, label, description, public_label, public_description, public_description_visible, public_display_order
+            SELECT feature_key, label, description, public_visible, public_label, public_description, public_description_visible, public_display_order
             FROM plan_feature_catalog_overrides
             WHERE tenant_id = ? AND is_custom = 1
             ORDER BY updated_at ASC, created_at ASC, feature_key ASC
@@ -108,6 +108,7 @@ export class PlanEntitlementService {
                 label,
                 description: this.normalizeRequiredCatalogLabel(row.description),
                 isCustom: true,
+                publicVisible: this.normalizeOptionalCatalogDescriptionVisible(row.public_visible),
                 publicLabel: this.normalizeOptionalCatalogMarketingCopy(row.public_label),
                 publicDescription: this.normalizeOptionalCatalogMarketingCopy(row.public_description),
                 publicDescriptionVisible: this.normalizeOptionalCatalogDescriptionVisible(row.public_description_visible),
@@ -123,7 +124,7 @@ export class PlanEntitlementService {
         if (!featureKey)
             return null;
         const row = this.db.prepare(`
-            SELECT feature_key, label, description, public_label, public_description, public_description_visible, public_display_order
+            SELECT feature_key, label, description, public_visible, public_label, public_description, public_description_visible, public_display_order
             FROM plan_feature_catalog_overrides
             WHERE tenant_id = ? AND feature_key = ? AND is_custom = 1
             LIMIT 1
@@ -138,6 +139,7 @@ export class PlanEntitlementService {
             label,
             description: this.normalizeRequiredCatalogLabel(row.description),
             isCustom: true,
+            publicVisible: this.normalizeOptionalCatalogDescriptionVisible(row.public_visible),
             publicLabel: this.normalizeOptionalCatalogMarketingCopy(row.public_label),
             publicDescription: this.normalizeOptionalCatalogMarketingCopy(row.public_description),
             publicDescriptionVisible: this.normalizeOptionalCatalogDescriptionVisible(row.public_description_visible),
@@ -148,7 +150,7 @@ export class PlanEntitlementService {
     }
     listPlanFeatureCatalogOverrideMap() {
         const rows = this.db.prepare(`
-            SELECT feature_key, public_label, public_description, public_description_visible, public_display_order, is_custom
+            SELECT feature_key, public_visible, public_label, public_description, public_description_visible, public_display_order, is_custom
             FROM plan_feature_catalog_overrides
             WHERE tenant_id = ?
         `).all(this.tenantId);
@@ -164,6 +166,7 @@ export class PlanEntitlementService {
                 continue;
             }
             overrides.set(featureKey, {
+                publicVisible: this.normalizeOptionalCatalogDescriptionVisible(row.public_visible),
                 publicLabel: this.normalizeOptionalCatalogMarketingCopy(row.public_label),
                 publicDescription: this.normalizeOptionalCatalogMarketingCopy(row.public_description),
                 publicDescriptionVisible: this.normalizeOptionalCatalogDescriptionVisible(row.public_description_visible),
@@ -255,12 +258,17 @@ export class PlanEntitlementService {
             };
         }
         if (normalizedFeatureKey === AI_PROFILES_FEATURE_KEY) {
+            const limit = this.readPositiveIntegerConfig(config[AI_PROFILES_LIMIT_CONFIG_KEY], 1);
             if (access === 'limited') {
-                const limit = this.readPositiveIntegerConfig(config[AI_PROFILES_LIMIT_CONFIG_KEY], 1);
                 return {
                     [AI_PROFILES_LIMIT_CONFIG_KEY]: limit ?? 1
                 };
             }
+            if (limit !== null) {
+                return {
+                    [AI_PROFILES_LIMIT_CONFIG_KEY]: limit
+                };
+            }
             return {};
         }
         return config && typeof config === 'object' ? { ...config } : {};
@@ -1650,6 +1658,7 @@ export class PlanEntitlementService {
                 label: feature.label,
                 description: feature.description,
                 isCustom: false,
+                publicVisible: overrides.get(feature.featureKey)?.publicVisible ?? feature.publicVisible ?? null,
                 publicLabel: overrides.get(feature.featureKey)?.publicLabel ?? feature.publicLabel ?? null,
                 publicDescription: overrides.get(feature.featureKey)?.publicDescription ?? feature.publicDescription ?? null,
                 publicDescriptionVisible: overrides.get(feature.featureKey)?.publicDescriptionVisible ?? feature.publicDescriptionVisible ?? null,
@@ -1669,6 +1678,7 @@ export class PlanEntitlementService {
         const featureKey = this.generateUniqueCustomPlanFeatureKey(label);
         const publicLabel = this.normalizeOptionalCatalogMarketingCopy(input.publicLabel);
         const publicDescription = this.normalizeOptionalCatalogMarketingCopy(input.publicDescription);
+        const publicVisible = this.normalizeOptionalCatalogDescriptionVisible(input.publicVisible);
         const publicDescriptionVisible = this.normalizeOptionalCatalogDescriptionVisible(input.publicDescriptionVisible);
         const publicDisplayOrder = this.normalizeOptionalCatalogDisplayOrder(input.publicDisplayOrder);
         const now = new Date().toISOString();
@@ -1679,6 +1689,7 @@ export class PlanEntitlementService {
                 label,
                 description,
                 is_custom,
+                public_visible,
                 public_label,
                 public_description,
                 public_description_visible,
@@ -1686,13 +1697,14 @@ export class PlanEntitlementService {
                 created_at,
                 updated_at
             )
-            VALUES (?, ?, ?, ?, 1, ?, ?, ?, ?, ?, ?)
-        `).run(this.tenantId, featureKey, label, description, publicLabel, publicDescription, publicDescriptionVisible === null ? null : (publicDescriptionVisible ? 1 : 0), publicDisplayOrder, now, now);
+            VALUES (?, ?, ?, ?, 1, ?, ?, ?, ?, ?, ?, ?)
+        `).run(this.tenantId, featureKey, label, description, publicVisible === null ? null : (publicVisible ? 1 : 0), publicLabel, publicDescription, publicDescriptionVisible === null ? null : (publicDescriptionVisible ? 1 : 0), publicDisplayOrder, now, now);
         return this.getCustomPlanFeatureCatalogEntry(featureKey) || {
             featureKey,
             label,
             description,
             isCustom: true,
+            publicVisible,
             publicLabel,
             publicDescription,
             publicDescriptionVisible,
@@ -1737,11 +1749,12 @@ export class PlanEntitlementService {
             throw new TaskforceRuleError('Feature label is required', 400, 'PLAN_FEATURE_LABEL_REQUIRED');
         const publicLabel = this.normalizeOptionalCatalogMarketingCopy(input.publicLabel);
         const publicDescription = this.normalizeOptionalCatalogMarketingCopy(input.publicDescription);
+        const publicVisible = this.normalizeOptionalCatalogDescriptionVisible(input.publicVisible);
         const publicDescriptionVisible = this.normalizeOptionalCatalogDescriptionVisible(input.publicDescriptionVisible);
         const publicDisplayOrder = this.normalizeOptionalCatalogDisplayOrder(input.publicDisplayOrder);
         const now = new Date().toISOString();
         const tx = this.db.transaction(() => {
-            if (!customFeature && !publicLabel && !publicDescription && publicDescriptionVisible === null && publicDisplayOrder === null) {
+            if (!customFeature && publicVisible === null && !publicLabel && !publicDescription && publicDescriptionVisible === null && publicDisplayOrder === null) {
                 this.db.prepare(`
                     DELETE FROM plan_feature_catalog_overrides
                     WHERE tenant_id = ? AND feature_key = ?
@@ -1755,6 +1768,7 @@ export class PlanEntitlementService {
                     label,
                     description,
                     is_custom,
+                    public_visible,
                     public_label,
                     public_description,
                     public_description_visible,
@@ -1762,17 +1776,18 @@ export class PlanEntitlementService {
                     created_at,
                     updated_at
                 )
-                VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+                VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
                 ON CONFLICT (tenant_id, feature_key) DO UPDATE SET
                     label = excluded.label,
                     description = excluded.description,
                     is_custom = excluded.is_custom,
+                    public_visible = excluded.public_visible,
                     public_label = excluded.public_label,
                     public_description = excluded.public_description,
                     public_description_visible = excluded.public_description_visible,
                     public_display_order = excluded.public_display_order,
                     updated_at = excluded.updated_at
-            `).run(this.tenantId, featureKey, customFeature ? label : null, customFeature ? description : null, customFeature ? 1 : 0, publicLabel, publicDescription, publicDescriptionVisible === null ? null : (publicDescriptionVisible ? 1 : 0), publicDisplayOrder, now, now);
+            `).run(this.tenantId, featureKey, customFeature ? label : null, customFeature ? description : null, customFeature ? 1 : 0, publicVisible === null ? null : (publicVisible ? 1 : 0), publicLabel, publicDescription, publicDescriptionVisible === null ? null : (publicDescriptionVisible ? 1 : 0), publicDisplayOrder, now, now);
         });
         tx();
         return this.listPlanFeatureCatalog().find((feature) => feature.featureKey === featureKey) || (customFeature ? {
@@ -1780,6 +1795,7 @@ export class PlanEntitlementService {
             label,
             description,
             isCustom: true,
+            publicVisible,
             publicLabel,
             publicDescription,
             publicDescriptionVisible,
@@ -1791,6 +1807,7 @@ export class PlanEntitlementService {
             label: catalogFeature.label,
             description: catalogFeature.description,
             isCustom: false,
+            publicVisible,
             publicLabel,
             publicDescription,
             publicDescriptionVisible,

package/dist/core/Taskforce.d.ts

@@ -618,6 +618,7 @@ export interface PlanFeatureCatalogItem {
     label: string;
     description: string;
     isCustom?: boolean;
+    publicVisible?: boolean | null;
     publicDescriptionVisible?: boolean | null;
     allowedAccessModes: PlanFeatureAccess[];
     configTemplate: Record<string, unknown>;
@@ -910,6 +911,8 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
     private tenantId;
     private db;
     private globalSettingsDb;
+    private readonly globalSettingsSchemaEnsuredStores;
+    private readonly structuredSettingsSchemaEnsuredStores;
     private authTokenService;
     private identityService;
     private mcpTokenService;
@@ -1623,6 +1626,7 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
     createCustomPlanFeatureCatalogEntry(input: {
         label: string;
         description?: string | null;
+        publicVisible?: boolean | null;
         publicLabel?: string | null;
         publicDescription?: string | null;
         publicDescriptionVisible?: boolean | null;
@@ -1633,6 +1637,7 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
         featureKey: string;
         label?: string | null;
         description?: string | null;
+        publicVisible?: boolean | null;
         publicLabel?: string | null;
         publicDescription?: string | null;
         publicDescriptionVisible?: boolean | null;

package/dist/core/Taskforce.js

@@ -40,6 +40,7 @@ import { formatInitiativeReference, formatWorkstreamReference, } from '../utils/
 import { getDocumentReferenceLabel } from '../utils/documentReferences.js';
 import { getImageReferenceLabel } from '../utils/imageReferences.js';
 import { getCanonicalDocumentName } from '../utils/documentNames.js';
+import { isPathInsideRoot, resolveStorageKeyPathInsideRoot } from '../utils/pathSafety.js';
 import { DEFAULT_TASKFORCE_THEME } from '../utils/theme.js';
 import { ensureAssigneeTaskSchema, ensureAnnotatedAttachmentSessionsSchema, ensureAuthIdentitySchema, ensureBillingSchema, ensureDocumentReviewSessionsSchema, ensureDocumentReferenceSchema, ensureEntitlementsSchema, ensureScheduleTaskSchema, ensureTaskAssetsSchema, ensureTaskReferenceSchema, ensureTenantSchema, ensureWorkspaceAssetsSchema, ensureWorkspaceSchema } from '../migrations/taskSchemaMigrations.js';
 export class TaskforceRuleError extends Error {
@@ -142,6 +143,8 @@ export class TaskforceCore {
     tenantId;
     db;
     globalSettingsDb = null;
+    globalSettingsSchemaEnsuredStores = new WeakSet();
+    structuredSettingsSchemaEnsuredStores = new WeakSet();
     authTokenService;
     identityService;
     mcpTokenService;
@@ -2961,6 +2964,8 @@ export class TaskforceCore {
         return this.globalSettingsDb || this.db;
     }
     ensureGlobalSettingsTable(store) {
+        if (this.globalSettingsSchemaEnsuredStores.has(store))
+            return;
         store.exec(`
             CREATE TABLE IF NOT EXISTS global_settings (
                 tenant_id TEXT PRIMARY KEY,
@@ -2968,8 +2973,11 @@ export class TaskforceCore {
                 updated_at TEXT NOT NULL
             );
         `);
+        this.globalSettingsSchemaEnsuredStores.add(store);
     }
     ensureStructuredSettingsTables(store) {
+        if (this.structuredSettingsSchemaEnsuredStores.has(store))
+            return;
         store.exec(`
             CREATE TABLE IF NOT EXISTS system_settings (
                 tenant_id TEXT NOT NULL DEFAULT 'default',
@@ -3002,6 +3010,7 @@ export class TaskforceCore {
             CREATE INDEX IF NOT EXISTS idx_user_preferences_user_key
             ON user_preferences(user_id, prefs_key);
         `);
+        this.structuredSettingsSchemaEnsuredStores.add(store);
     }
     readSettingsPayloadRow(store, tableName, whereValues) {
         try {
@@ -3260,8 +3269,13 @@ export class TaskforceCore {
                     };
                 }
                 if (storageProvider !== 'r2') {
-                    const candidatePath = path.join(this.basePath, storageKey);
-                    if (!fs.existsSync(candidatePath) || !fs.statSync(candidatePath).isFile()) {
+                    const candidatePath = resolveStorageKeyPathInsideRoot(this.basePath, storageKey);
+                    if (!candidatePath || !fs.existsSync(candidatePath) || !fs.statSync(candidatePath).isFile()) {
+                        return null;
+                    }
+                    const storageRoot = fs.existsSync(this.basePath) ? fs.realpathSync(this.basePath) : path.resolve(this.basePath);
+                    const realCandidatePath = fs.realpathSync(candidatePath);
+                    if (!isPathInsideRoot(realCandidatePath, storageRoot)) {
                         return null;
                     }
                 }

package/dist/core/types.d.ts

@@ -511,6 +511,7 @@ export interface PlanFeatureCatalogItem {
     label: string;
     description: string;
     isCustom?: boolean;
+    publicVisible?: boolean | null;
     publicLabel?: string | null;
     publicDescription?: string | null;
     publicDescriptionVisible?: boolean | null;

package/dist/hooks/sync/recovery.d.ts

@@ -59,6 +59,7 @@ interface CreateSyncRecoveryCoordinatorArgs {
     persistWorkspaceSyncPatch: (patch: {
         phase: WorkspaceSyncPhase;
         pullCursor: null;
+        startupFullReconcileCompletedAt: null;
         lastErrorMessage: null;
     }) => Promise<unknown>;
     persistWorkspaceSyncWatermarksSnapshotBestEffort: () => boolean;

package/dist/hooks/sync/recovery.js

@@ -214,6 +214,7 @@ export function createSyncRecoveryCoordinator({ currentWorkspaceId, workspaceClo
             await persistWorkspaceSyncPatch({
                 phase: repairPhase,
                 pullCursor: null,
+                startupFullReconcileCompletedAt: null,
                 lastErrorMessage: null
             });
             if (repairPhase === 'provision-local') {

package/dist/hooks/sync/transfers.d.ts

@@ -32,6 +32,7 @@ interface CreateWorkspaceTransferCoordinatorArgs {
         lastPushAt?: string;
         lastPullAt?: string;
         lastSyncedAt: string;
+        startupFullReconcileCompletedAt?: string | null;
         pullCursor?: string | null;
         lastErrorMessage: null;
     } | {
@@ -42,6 +43,7 @@ interface CreateWorkspaceTransferCoordinatorArgs {
         pullCursor: string | null;
         lastPullAt: string;
         lastSyncedAt: string;
+        startupFullReconcileCompletedAt?: string | null;
         lastErrorMessage: null;
     }) => Promise<unknown>;
     persistWorkspaceSyncWatermarksSnapshotBestEffort: () => boolean;

package/dist/hooks/sync/transfers.js

@@ -486,6 +486,9 @@ export function createWorkspaceTransferCoordinator({ cloudAuthConfigured, runtim
                 pullCursor: workspacePullCursorRef.current,
                 lastPullAt: syncedAt,
                 lastSyncedAt: syncedAt,
+                ...(options?.forceCursorNull === true
+                    ? { startupFullReconcileCompletedAt: syncedAt }
+                    : {}),
                 lastErrorMessage: null
             });
             reportSyncEvent(currentWorkspaceId, {

package/dist/hooks/useSyncOrchestrator.js

@@ -527,7 +527,7 @@ export function useSyncOrchestrator(input) {
         workspaceLastPushedAnnotatedAttachmentSessionIdsRef.current = new Set();
         workspaceLastPushedAnnotatedAttachmentSessionWatermarksRef.current = new Map();
         workspaceLastPushedTaskEventWatermarksRef.current = new Map();
-        workspaceStartupFullReconcileRanRef.current = false;
+        workspaceStartupFullReconcileRanRef.current = Boolean(readWorkspaceSyncStateSnapshot().startupFullReconcileCompletedAt);
         workspaceFullReconcileInFlightRef.current = false;
         const persisted = readPersistedSyncWatermarks(currentWorkspaceId, taxonomyStateFingerprint);
         if (!hydrateWorkspacePushBaselines(persisted)) {
@@ -556,6 +556,14 @@ export function useSyncOrchestrator(input) {
         workspaceCloudSyncEnabled,
         workspaceSyncPhase
     ]);
+    useEffect(() => {
+        workspaceStartupFullReconcileRanRef.current = Boolean(readWorkspaceSyncStateSnapshot().startupFullReconcileCompletedAt);
+    }, [
+        currentWorkspaceId,
+        readWorkspaceSyncStateSnapshot,
+        workspaceLastPullAt,
+        workspaceSyncPhase
+    ]);
     const scheduleWorkspaceSyncRetry = useCallback((minDelayMs) => {
         scheduleWorkspaceRetry(() => retryWorkspaceSyncRef.current(), { minDelayMs });
     }, [scheduleWorkspaceRetry]);

package/dist/hooks/useTaskforce.js

@@ -2708,14 +2708,21 @@ export function useTaskforce({ config = {}, initialTaskId, onTaskCountChange, on
             onTaskCountChange(tasks.length);
         }
     }, [tasks.length, onTaskCountChange]);
+    const handledInitialTaskIdRef = useRef(null);
     // Deep linking handler
     useEffect(() => {
-        if (initialTaskId && tasks.length > 0) {
-            const task = tasks.find(t => t.id.endsWith(initialTaskId) || t.id === initialTaskId);
-            if (task) {
-                handleEdit(task);
-                setActiveTab('add');
-            }
+        if (!initialTaskId) {
+            handledInitialTaskIdRef.current = null;
+            return;
+        }
+        if (handledInitialTaskIdRef.current === initialTaskId || tasks.length === 0) {
+            return;
+        }
+        const task = tasks.find(t => t.id.endsWith(initialTaskId) || t.id === initialTaskId);
+        if (task) {
+            handledInitialTaskIdRef.current = initialTaskId;
+            handleEdit(task);
+            setActiveTab('add');
         }
     }, [initialTaskId, tasks]);
     // Update active category logic

package/dist/hooks/useWorkspaceSyncController.js

@@ -60,6 +60,9 @@ function buildWorkspaceSyncStatePatch(current, patch) {
         version: 2,
         phase: patch.phase || current.phase,
         setupIntent: patch.setupIntent === undefined ? (current.setupIntent ?? null) : (patch.setupIntent ?? null),
+        startupFullReconcileCompletedAt: patch.startupFullReconcileCompletedAt === undefined
+            ? (current.startupFullReconcileCompletedAt ?? null)
+            : normalizeCursor(patch.startupFullReconcileCompletedAt),
         pullCursor: patch.pullCursor === undefined ? current.pullCursor : normalizeCursor(patch.pullCursor),
         lastPullAt: patch.lastPullAt === undefined ? current.lastPullAt : normalizeCursor(patch.lastPullAt),
         lastPushAt: patch.lastPushAt === undefined ? current.lastPushAt : normalizeCursor(patch.lastPushAt),