@taskforcehq/taskforce 0.3.170 → 0.3.301

package/dist/components/features/DocumentWorkspace.d.ts

@@ -1,21 +1,59 @@
+import { type DocumentAttachmentFilter, type DocumentTypeFilter } from './documentWorkspaceFilters';
 export interface DocMeta {
     id: string;
+    assetId?: string;
+    referenceNumber?: number | null;
+    referenceLabel?: string | null;
     fsPath: string;
     apiUrl: string;
     taskId: string | null;
+    displayName: string;
+    originalFilename?: string | null;
     title: string;
     docType: 'implementation-plan' | 'review' | 'walkthrough' | 'planning' | 'other';
     sizeBytes: number;
     updatedAt: string | null;
+    editable?: boolean;
+    attachmentCount?: number;
+    attachmentState?: 'attached' | 'unattached' | 'standalone';
 }
+export type { DocumentAttachmentFilter, DocumentTypeFilter } from './documentWorkspaceFilters';
+export { DOCUMENT_TYPE_FILTER_OPTIONS, DOCUMENT_ATTACHMENT_FILTER_OPTIONS } from './documentWorkspaceFilters';
 interface Props {
     tasks: Array<{
         id: string;
         title: string;
     }>;
     apiBaseUrl?: string;
+    documents: DocMeta[];
+    loading: boolean;
+    error: string | null;
+    selectedDoc: DocMeta | null;
+    searchQuery: string;
+    typeFilters: DocumentTypeFilter[];
+    attachmentFilters: DocumentAttachmentFilter[];
+    onSearchChange: (value: string) => void;
+    onSelectDoc: (doc: DocMeta | null) => void;
+    onRefresh: () => Promise<void> | void;
+    enableTaskGeneration?: boolean;
+}
+interface ShellProps {
+    tasks: Array<{
+        id: string;
+        title: string;
+    }>;
+    runtimeMode?: 'local' | 'cloud';
+    apiBaseUrl?: string;
+    cloudAuthBaseUrl?: string;
+    typeFilters?: DocumentTypeFilter[];
+    attachmentFilters?: DocumentAttachmentFilter[];
+    onTypeFiltersChange?: (values: DocumentTypeFilter[]) => void;
+    onAttachmentFiltersChange?: (values: DocumentAttachmentFilter[]) => void;
     requestedDocPath?: string | null;
+    requestedDocAssetId?: string | null;
     onRequestedDocHandled?: () => void;
+    enableTaskGeneration?: boolean;
 }
-export declare function DocumentWorkspace({ tasks, apiBaseUrl, requestedDocPath, onRequestedDocHandled }: Props): import("react/jsx-runtime").JSX.Element;
-export {};
+export declare function getEffectiveAttachmentState(doc: Pick<DocMeta, 'attachmentState' | 'attachmentCount' | 'taskId'>): 'attached' | 'unattached';
+export declare function DocumentWorkspace({ tasks, apiBaseUrl, documents, loading, error, selectedDoc, searchQuery, typeFilters, attachmentFilters, onSearchChange, onSelectDoc, onRefresh, enableTaskGeneration }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function DocumentWorkspaceShell({ tasks, runtimeMode, apiBaseUrl, cloudAuthBaseUrl, typeFilters: controlledTypeFilters, attachmentFilters: controlledAttachmentFilters, onTypeFiltersChange, onAttachmentFiltersChange, requestedDocPath, requestedDocAssetId, onRequestedDocHandled, enableTaskGeneration }: ShellProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/features/DocumentWorkspace.js

@@ -4,6 +4,10 @@ import styles from '../../Taskforce.module.css';
 import { DocumentIndex } from './DocumentIndex';
 import { DocumentViewer } from './DocumentViewer';
 import { fetchTaskforceApi } from '../../utils/taskforceApiClient';
+import { logDocumentManagerDebug, resolveDocumentManagerApiBase } from '../../utils/documentManagerApi';
+import { getReadableDocumentName } from '../../utils/documentNames';
+import { DOCUMENT_ATTACHMENT_FILTER_OPTIONS, DOCUMENT_TYPE_FILTER_OPTIONS, } from './documentWorkspaceFilters';
+export { DOCUMENT_TYPE_FILTER_OPTIONS, DOCUMENT_ATTACHMENT_FILTER_OPTIONS } from './documentWorkspaceFilters';
 function normalizeDocPath(value) {
     let decoded = value;
     try {
@@ -29,46 +33,112 @@ function docPathMatches(candidate, requested) {
         return true;
     return false;
 }
-export function DocumentWorkspace({ tasks, apiBaseUrl = '', requestedDocPath = null, onRequestedDocHandled }) {
+function extractAssetIdFromPath(value) {
+    const normalized = normalizeDocPath(String(value || ''));
+    if (!normalized)
+        return null;
+    const match = normalized.match(/(^|\/)(asset-[a-f0-9]{32})(?=[^/]*$)/i);
+    return match?.[2] ? match[2].toLowerCase() : null;
+}
+export function getEffectiveAttachmentState(doc) {
+    if (doc.attachmentState === 'attached' || doc.attachmentState === 'unattached') {
+        return doc.attachmentState;
+    }
+    const attachmentCount = typeof doc.attachmentCount === 'number' && Number.isFinite(doc.attachmentCount)
+        ? doc.attachmentCount
+        : 0;
+    if (attachmentCount > 0 || !!doc.taskId) {
+        return 'attached';
+    }
+    return 'unattached';
+}
+export function DocumentWorkspace({ tasks, apiBaseUrl = '', documents, loading, error, selectedDoc, searchQuery, typeFilters, attachmentFilters, onSearchChange, onSelectDoc, onRefresh, enableTaskGeneration = false }) {
+    const filteredDocs = documents.filter(doc => {
+        const readableName = getReadableDocumentName(doc);
+        const haystack = `${readableName} ${doc.originalFilename || ''}`.toLowerCase();
+        const matchesSearch = !searchQuery || haystack.includes(searchQuery.toLowerCase());
+        const matchesType = typeFilters.length === 0 || typeFilters.includes(doc.docType);
+        const attachmentState = getEffectiveAttachmentState(doc);
+        const matchesAttachment = attachmentFilters.length === 0 || attachmentFilters.includes(attachmentState);
+        return matchesSearch && matchesType && matchesAttachment;
+    });
+    const hasActiveFilters = searchQuery.trim().length > 0 || typeFilters.length > 0 || attachmentFilters.length > 0;
+    const taskById = new Map(tasks.map(t => [t.id, t]));
+    return (_jsxs("div", { className: styles.docWorkspace, children: [_jsx("div", { className: styles.docIndexPanel, children: _jsx(DocumentIndex, { documents: filteredDocs, selectedDocId: selectedDoc?.id ?? null, loading: loading, error: error, searchQuery: searchQuery, onSearchChange: onSearchChange, onSelect: (doc) => onSelectDoc(doc), onRefresh: onRefresh, taskById: taskById, hasActiveFilters: hasActiveFilters }) }), _jsx("div", { className: styles.docViewerPanel, children: selectedDoc ? (_jsx(DocumentViewer, { doc: selectedDoc, taskTitle: selectedDoc.taskId ? (taskById.get(selectedDoc.taskId)?.title ?? null) : null, apiBaseUrl: apiBaseUrl, onSaved: (_updatedAt) => onRefresh(), onDeleted: () => {
+                        onSelectDoc(null);
+                        void onRefresh();
+                    }, enableTaskGeneration: enableTaskGeneration })) : !loading && (_jsx("div", { className: styles.docViewerEmpty, children: _jsx("p", { className: "tf-empty-copy", children: filteredDocs.length === 0 ? 'No documents match your current filters.' : 'Select a document to view it.' }) })) })] }));
+}
+export function DocumentWorkspaceShell({ tasks, runtimeMode = 'local', apiBaseUrl = '', cloudAuthBaseUrl = '', typeFilters: controlledTypeFilters, attachmentFilters: controlledAttachmentFilters, onTypeFiltersChange, onAttachmentFiltersChange, requestedDocPath = null, requestedDocAssetId = null, onRequestedDocHandled, enableTaskGeneration = false }) {
     const [documents, setDocuments] = useState([]);
     const [loading, setLoading] = useState(true);
     const [error, setError] = useState(null);
     const [selectedDoc, setSelectedDoc] = useState(null);
     const [searchQuery, setSearchQuery] = useState('');
-    const [typeFilter, setTypeFilter] = useState('all');
+    const [internalTypeFilters, setInternalTypeFilters] = useState(() => DOCUMENT_TYPE_FILTER_OPTIONS.map((option) => option.value));
+    const [internalAttachmentFilters, setInternalAttachmentFilters] = useState(() => DOCUMENT_ATTACHMENT_FILTER_OPTIONS.map((option) => option.value));
+    const documentApiBaseUrl = resolveDocumentManagerApiBase({
+        runtimeMode,
+        apiBaseUrl,
+        cloudAuthBaseUrl,
+    });
+    const typeFilters = controlledTypeFilters ?? internalTypeFilters;
+    const attachmentFilters = controlledAttachmentFilters ?? internalAttachmentFilters;
+    const handleTypeFiltersChange = onTypeFiltersChange ?? setInternalTypeFilters;
+    const handleAttachmentFiltersChange = onAttachmentFiltersChange ?? setInternalAttachmentFilters;
     const fetchDocuments = useCallback(async () => {
         setLoading(true);
         setError(null);
         try {
             const res = await fetchTaskforceApi('/api/taskforce/documents', {
                 credentials: 'include',
-            }, apiBaseUrl);
+            }, documentApiBaseUrl);
             if (!res.ok)
                 throw new Error(`Failed to load documents (${res.status})`);
             const data = await res.json();
-            setDocuments(data.documents || []);
+            const nextDocuments = data.documents || [];
+            logDocumentManagerDebug('list.loaded', {
+                runtimeMode,
+                apiBaseUrl: documentApiBaseUrl || '(same-origin)',
+                count: Array.isArray(nextDocuments) ? nextDocuments.length : 0,
+            });
+            setDocuments(nextDocuments);
         }
         catch (e) {
             setError(e?.message || 'Failed to load documents');
+            logDocumentManagerDebug('list.error', {
+                runtimeMode,
+                apiBaseUrl: documentApiBaseUrl || '(same-origin)',
+                message: e?.message || 'Failed to load documents',
+            });
         }
         finally {
             setLoading(false);
         }
-    }, [apiBaseUrl]);
+    }, [documentApiBaseUrl, runtimeMode]);
     useEffect(() => {
         fetchDocuments();
     }, [fetchDocuments]);
     // Auto-select first doc when list loads
     useEffect(() => {
+        if (requestedDocPath || requestedDocAssetId)
+            return;
         if (!selectedDoc && documents.length > 0) {
             setSelectedDoc(documents[0]);
         }
-    }, [documents, selectedDoc]);
+    }, [documents, selectedDoc, requestedDocAssetId, requestedDocPath]);
     useEffect(() => {
-        if (!requestedDocPath || documents.length === 0)
+        if ((!requestedDocPath && !requestedDocAssetId) || documents.length === 0)
             return;
-        const requested = normalizeDocPath(requestedDocPath);
+        const requested = requestedDocPath ? normalizeDocPath(requestedDocPath) : '';
+        const requestedAssetId = String(requestedDocAssetId || '').trim().toLowerCase()
+            || extractAssetIdFromPath(requestedDocPath);
         const matched = documents.find((doc) => {
+            const candidateAssetId = extractAssetIdFromPath(doc.fsPath) || String(doc.assetId || '').trim().toLowerCase() || null;
+            if (requestedAssetId && candidateAssetId && candidateAssetId === requestedAssetId)
+                return true;
+            if (!requested)
+                return false;
             const candidate = normalizeDocPath(doc.fsPath);
             return docPathMatches(candidate, requested);
         });
@@ -77,12 +147,22 @@ export function DocumentWorkspace({ tasks, apiBaseUrl = '', requestedDocPath = n
             onRequestedDocHandled?.();
             return;
         }
-    }, [requestedDocPath, documents, onRequestedDocHandled]);
-    const filteredDocs = documents.filter(doc => {
-        const matchesSearch = !searchQuery || doc.title.toLowerCase().includes(searchQuery.toLowerCase());
-        const matchesType = typeFilter === 'all' || doc.docType === typeFilter;
-        return matchesSearch && matchesType;
-    });
-    const taskById = new Map(tasks.map(t => [t.id, t]));
-    return (_jsxs("div", { className: styles.docWorkspace, children: [_jsx("div", { className: styles.docIndexPanel, children: _jsx(DocumentIndex, { documents: filteredDocs, selectedDocId: selectedDoc?.id ?? null, loading: loading, error: error, searchQuery: searchQuery, typeFilter: typeFilter, onSearchChange: setSearchQuery, onTypeFilterChange: setTypeFilter, onSelect: setSelectedDoc, onRefresh: fetchDocuments, taskById: taskById }) }), _jsx("div", { className: styles.docViewerPanel, children: selectedDoc ? (_jsx(DocumentViewer, { doc: selectedDoc, taskTitle: selectedDoc.taskId ? (taskById.get(selectedDoc.taskId)?.title ?? null) : null, apiBaseUrl: apiBaseUrl, onSaved: (_updatedAt) => fetchDocuments() })) : !loading && (_jsx("div", { className: styles.docViewerEmpty, children: _jsx("p", { children: documents.length === 0 ? 'No documents found.' : 'Select a document to view it.' }) })) })] }));
+    }, [requestedDocAssetId, requestedDocPath, documents, onRequestedDocHandled]);
+    useEffect(() => {
+        if ((requestedDocPath || requestedDocAssetId) && !selectedDoc)
+            return;
+        const filtered = documents.filter((doc) => {
+            const readableName = getReadableDocumentName(doc);
+            const haystack = `${readableName} ${doc.originalFilename || ''}`.toLowerCase();
+            const matchesSearch = !searchQuery || haystack.includes(searchQuery.toLowerCase());
+            const matchesType = typeFilters.length === 0 || typeFilters.includes(doc.docType);
+            const attachmentState = getEffectiveAttachmentState(doc);
+            const matchesAttachment = attachmentFilters.length === 0 || attachmentFilters.includes(attachmentState);
+            return matchesSearch && matchesType && matchesAttachment;
+        });
+        if (selectedDoc && filtered.some((doc) => doc.id === selectedDoc.id))
+            return;
+        setSelectedDoc(filtered[0] ?? null);
+    }, [attachmentFilters, documents, requestedDocAssetId, requestedDocPath, searchQuery, selectedDoc, typeFilters]);
+    return (_jsx(DocumentWorkspace, { tasks: tasks, apiBaseUrl: documentApiBaseUrl, documents: documents, loading: loading, error: error, selectedDoc: selectedDoc, searchQuery: searchQuery, typeFilters: typeFilters, attachmentFilters: attachmentFilters, onSearchChange: setSearchQuery, onSelectDoc: setSelectedDoc, onRefresh: fetchDocuments, enableTaskGeneration: enableTaskGeneration }));
 }