elspais 0.11.1__py3-none-any.whl → 0.43.5__py3-none-any.whl

elspais/trace_view/html/templates/partials/review/review-status.js

@@ -1,659 +0,0 @@
-/**
- * TraceView Review Status Request UI Module
- *
- * User interface for status change requests:
- * - Status change request form
- * - Approval workflow display
- * - Pending request badges
- *
- * IMPLEMENTS REQUIREMENTS:
- *   REQ-tv-d00016: Review JavaScript Integration
- */
-
-// Ensure TraceView.review namespace exists
-window.TraceView = window.TraceView || {};
-TraceView.review = TraceView.review || {};
-
-(function(review) {
-    'use strict';
-
-    // ==========================================================================
-    // Templates
-    // ==========================================================================
-
-    /**
-     * Check if a REQ is in the active package
-     * @param {string} reqId - Requirement ID
-     * @returns {boolean} True if REQ is in active package
-     */
-    function isReqInActivePackage(reqId) {
-        const packages = review.packages;
-        if (!packages || !packages.activeId) return false;
-        const activePkg = packages.items.find(p => p.packageId === packages.activeId);
-        return activePkg && activePkg.reqIds && activePkg.reqIds.includes(reqId);
-    }
-
-    /**
-     * Create status request panel HTML
-     * @param {string} reqId - Requirement ID
-     * @param {string} currentStatus - Current status of the requirement
-     * @returns {string} HTML
-     */
-    function statusPanelTemplate(reqId, currentStatus) {
-        // Show quick add button for Draft REQs - adds to review package
-        const quickToggle = currentStatus === 'Draft' ? `
-            <button class="rs-btn rs-btn-primary rs-quick-toggle" data-req-id="${reqId}">
-                Add to Review
-            </button>
-        ` : '';
-
-        // Package membership button
-        const inPackage = isReqInActivePackage(reqId);
-        const packageBtn = `
-            <button class="rs-btn ${inPackage ? 'rs-btn-danger' : 'rs-btn-secondary'} rs-package-toggle" data-req-id="${reqId}">
-                ${inPackage ? '− Remove from Package' : '+ Add to Package'}
-            </button>
-        `;
-
-        return `
-            <div class="rs-status-panel" data-req-id="${reqId}">
-                <div class="rs-status-header">
-                    <h4>Status</h4>
-                    <span class="rs-current-status status-badge status-${currentStatus.toLowerCase()}">
-                        ${escapeHtml(currentStatus)}
-                    </span>
-                </div>
-                <div class="rs-quick-actions">
-                    ${quickToggle}
-                    ${packageBtn}
-                </div>
-                <div class="rs-status-content">
-                    <div class="rs-requests"></div>
-                    <div class="rs-no-requests" style="display: none;">
-                        No pending status change requests.
-                    </div>
-                </div>
-                <div class="rs-status-actions">
-                    <button class="rs-btn rs-btn-secondary rs-request-change-btn">
-                        Request Status Change
-                    </button>
-                </div>
-            </div>
-        `;
-    }
-
-    /**
-     * Create status request card HTML
-     * @param {StatusRequest} request - Request object
-     * @returns {string} HTML
-     */
-    function requestCardTemplate(request) {
-        const stateClass = `rs-state-${request.state}`;
-        const stateLabel = getStateLabel(request.state);
-        const progressPercent = getApprovalProgress(request);
-
-        return `
-            <div class="rs-request-card ${stateClass}" data-request-id="${request.requestId}">
-                <div class="rs-request-header">
-                    <span class="rs-request-transition">
-                        ${escapeHtml(request.fromStatus)} -> ${escapeHtml(request.toStatus)}
-                    </span>
-                    <span class="rs-request-state rs-badge rs-badge-${request.state}">
-                        ${stateLabel}
-                    </span>
-                </div>
-                <div class="rs-request-meta">
-                    <span>Requested by <strong>${escapeHtml(request.requestedBy)}</strong></span>
-                    <span>${formatTime(request.requestedAt)}</span>
-                </div>
-                <div class="rs-request-justification">
-                    ${formatCommentBody(request.justification)}
-                </div>
-                <div class="rs-approval-progress">
-                    <div class="rs-progress-bar">
-                        <div class="rs-progress-fill" style="width: ${progressPercent}%"></div>
-                    </div>
-                    <span class="rs-progress-label">
-                        ${request.approvals.length}/${request.requiredApprovers.length} approvals
-                    </span>
-                </div>
-                <div class="rs-approvers-list">
-                    ${renderApproversList(request)}
-                </div>
-                ${request.state === review.RequestState.PENDING ? renderApprovalActions(request) : ''}
-            </div>
-        `;
-    }
-
-    /**
-     * Render approvers list with status
-     * @param {StatusRequest} request - Request object
-     * @returns {string} HTML
-     */
-    function renderApproversList(request) {
-        const approvalMap = {};
-        request.approvals.forEach(a => {
-            approvalMap[a.user] = a;
-        });
-
-        return `
-            <div class="rs-approvers">
-                ${request.requiredApprovers.map(approver => {
-                    const approval = approvalMap[approver];
-                    if (approval) {
-                        const icon = approval.decision === 'approve' ? '[+]' : '[-]';
-                        const cls = approval.decision === 'approve' ? 'approved' : 'rejected';
-                        return `
-                            <span class="rs-approver rs-approver-${cls}" title="${approval.comment || ''}">
-                                ${icon} ${escapeHtml(approver)}
-                            </span>
-                        `;
-                    } else {
-                        return `
-                            <span class="rs-approver rs-approver-pending">
-                                [ ] ${escapeHtml(approver)}
-                            </span>
-                        `;
-                    }
-                }).join('')}
-            </div>
-        `;
-    }
-
-    /**
-     * Render approval action buttons
-     * @param {StatusRequest} request - Request object
-     * @returns {string} HTML
-     */
-    function renderApprovalActions(request) {
-        const user = review.state.currentUser;
-        if (!user || !request.requiredApprovers.includes(user)) {
-            return '';
-        }
-
-        // Check if user already approved
-        const existing = request.approvals.find(a => a.user === user);
-        if (existing) {
-            return `<div class="rs-already-voted">You have already ${existing.decision}d this request.</div>`;
-        }
-
-        return `
-            <div class="rs-approval-actions">
-                <button class="rs-btn rs-btn-success rs-approve-btn">Approve</button>
-                <button class="rs-btn rs-btn-danger rs-reject-btn">Reject</button>
-                <input type="text" class="rs-approval-comment" placeholder="Comment (optional)">
-            </div>
-        `;
-    }
-
-    /**
-     * Create new request form HTML
-     * @param {string} reqId - Requirement ID
-     * @param {string} currentStatus - Current status
-     * @returns {string} HTML
-     */
-    function requestFormTemplate(reqId, currentStatus) {
-        const transitions = getValidTransitions(currentStatus);
-
-        return `
-            <div class="rs-request-form" data-req-id="${reqId}">
-                <h4>Request Status Change</h4>
-                <div class="rs-form-group">
-                    <label>Current Status</label>
-                    <span class="rs-current-status-display">${escapeHtml(currentStatus)}</span>
-                </div>
-                <div class="rs-form-group">
-                    <label>New Status</label>
-                    <select class="rs-new-status">
-                        ${transitions.map(status =>
-                            `<option value="${status}">${status}</option>`
-                        ).join('')}
-                    </select>
-                </div>
-                <div class="rs-form-group">
-                    <label>Justification</label>
-                    <textarea class="rs-justification" rows="3"
-                              placeholder="Explain why this status change is needed..."></textarea>
-                </div>
-                <div class="rs-required-approvers">
-                    <label>Required Approvers</label>
-                    <span class="rs-approvers-display"></span>
-                </div>
-                <div class="rs-form-actions">
-                    <button class="rs-btn rs-btn-primary rs-submit-request">Submit Request</button>
-                    <button class="rs-btn rs-cancel-request">Cancel</button>
-                </div>
-            </div>
-        `;
-    }
-
-    // ==========================================================================
-    // Helper Functions
-    // ==========================================================================
-
-    function escapeHtml(text) {
-        const div = document.createElement('div');
-        div.textContent = text;
-        return div.innerHTML;
-    }
-
-    function formatTime(isoString) {
-        try {
-            const date = new Date(isoString);
-            return date.toLocaleDateString() + ' ' + date.toLocaleTimeString([], {hour: '2-digit', minute:'2-digit'});
-        } catch (e) {
-            return isoString;
-        }
-    }
-
-    function formatCommentBody(body) {
-        let html = escapeHtml(body);
-        html = html.replace(/\n/g, '<br>');
-        return html;
-    }
-
-    function getStateLabel(state) {
-        switch (state) {
-            case review.RequestState.PENDING: return 'Pending';
-            case review.RequestState.APPROVED: return 'Approved';
-            case review.RequestState.REJECTED: return 'Rejected';
-            case review.RequestState.APPLIED: return 'Applied';
-            default: return state;
-        }
-    }
-
-    function getApprovalProgress(request) {
-        if (request.requiredApprovers.length === 0) return 100;
-        const approved = request.approvals.filter(a => a.decision === 'approve').length;
-        return Math.round((approved / request.requiredApprovers.length) * 100);
-    }
-
-    function getValidTransitions(currentStatus) {
-        const transitions = {
-            'Draft': ['Review', 'Active', 'Deprecated'],
-            'Review': ['Active', 'Draft', 'Deprecated'],
-            'Active': ['Deprecated'],
-            'Deprecated': [] // No transitions from Deprecated
-        };
-        return transitions[currentStatus] || [];
-    }
-
-    /**
-     * Change status directly via API (no approval workflow)
-     * @param {string} reqId - Requirement ID
-     * @param {string} newStatus - New status to set
-     * @returns {Promise<object>} API response
-     */
-    async function changeStatusDirect(reqId, newStatus) {
-        const user = review.state.currentUser || 'anonymous';
-        try {
-            const response = await fetch(`/api/reviews/reqs/${reqId}/status`, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ newStatus, user })
-            });
-            const result = await response.json();
-            if (result.success) {
-                // Update local state
-                const reqData = window.REQ_CONTENT_DATA && window.REQ_CONTENT_DATA[reqId];
-                if (reqData) {
-                    reqData.status = newStatus;
-                }
-                // Refresh status display
-                updateStatusBadge(reqId, newStatus);
-
-                // Handle auto-add to package when status changes to Review
-                if (result.addedToPackage && typeof review.renderPackagesPanel === 'function') {
-                    // Update local package state
-                    const pkg = review.packages && review.packages.items &&
-                                review.packages.items.find(p => p.packageId === result.addedToPackage.packageId);
-                    if (pkg && !pkg.reqIds.includes(reqId)) {
-                        pkg.reqIds.push(reqId);
-                    }
-                    // Re-render packages panel to update counts
-                    review.renderPackagesPanel();
-                    console.log(`REQ-${reqId} added to package: ${result.addedToPackage.packageName}`);
-                }
-            }
-            return result;
-        } catch (error) {
-            console.error('Error changing status:', error);
-            return { success: false, error: error.message };
-        }
-    }
-    review.changeStatusDirect = changeStatusDirect;
-
-    /**
-     * Update status badge in the UI
-     * @param {string} reqId - Requirement ID
-     * @param {string} newStatus - New status
-     */
-    function updateStatusBadge(reqId, newStatus) {
-        // Update in grid/tree
-        const statusBadge = document.querySelector(`[data-req-id="${reqId}"] .status-badge`);
-        if (statusBadge) {
-            statusBadge.className = `status-badge status-${newStatus.toLowerCase()}`;
-            statusBadge.textContent = newStatus;
-        }
-        // Update in middle column if visible
-        const middleStatusBadge = document.querySelector(`#req-card-${reqId} .status-badge`);
-        if (middleStatusBadge) {
-            middleStatusBadge.className = `status-badge status-${newStatus.toLowerCase()}`;
-            middleStatusBadge.textContent = newStatus;
-        }
-    }
-    review.updateStatusBadge = updateStatusBadge;
-
-    /**
-     * Add Draft REQ to review package (shortcut for review mode)
-     * Note: Does NOT change status - valid statuses are Draft, Active, Deprecated only.
-     * This just adds the REQ to the active review package for tracking.
-     * @param {string} reqId - Requirement ID
-     * @returns {Promise<object>} API response
-     */
-    async function toggleToReview(reqId) {
-        const reqData = window.REQ_CONTENT_DATA && window.REQ_CONTENT_DATA[reqId];
-        if (!reqData) return { success: false, error: 'REQ not found' };
-
-        if (reqData.status === 'Draft') {
-            // Add to active package for review tracking (don't change status)
-            if (review.addReqToActivePackage) {
-                const packageResult = await review.addReqToActivePackage(reqId);
-                if (packageResult && packageResult.success) {
-                    console.log(`REQ-${reqId} added to review package`);
-                    return { success: true, addedToPackage: packageResult };
-                } else {
-                    return { success: false, error: packageResult?.error || 'Failed to add to package' };
-                }
-            }
-            return { success: false, error: 'Package system not available' };
-        }
-        return { success: false, error: 'REQ is not in Draft status' };
-    }
-    review.toggleToReview = toggleToReview;
-
-    // ==========================================================================
-    // UI Components
-    // ==========================================================================
-
-    /**
-     * Render status panel for a requirement
-     * @param {Element} container - Container element
-     * @param {string} reqId - Requirement ID
-     * @param {string} currentStatus - Current requirement status
-     */
-    function renderStatusPanel(container, reqId, currentStatus) {
-        container.innerHTML = statusPanelTemplate(reqId, currentStatus);
-
-        const requests = review.state.getRequests(reqId);
-        const requestsContainer = container.querySelector('.rs-requests');
-        const noRequests = container.querySelector('.rs-no-requests');
-
-        if (requests.length === 0) {
-            noRequests.style.display = 'block';
-        } else {
-            requests.forEach(request => {
-                requestsContainer.insertAdjacentHTML('beforeend', requestCardTemplate(request));
-            });
-            bindRequestEvents(container);
-        }
-
-        // Bind quick toggle button
-        const quickToggleBtn = container.querySelector('.rs-quick-toggle');
-        if (quickToggleBtn) {
-            quickToggleBtn.addEventListener('click', async () => {
-                quickToggleBtn.disabled = true;
-                quickToggleBtn.textContent = 'Updating...';
-                const result = await toggleToReview(reqId);
-                if (result.success) {
-                    // Re-render the panel with new status
-                    renderStatusPanel(container, reqId, 'Review');
-                } else {
-                    quickToggleBtn.disabled = false;
-                    quickToggleBtn.textContent = 'Set to Review';
-                    alert('Failed to change status: ' + (result.error || 'Unknown error'));
-                }
-            });
-        }
-
-        // Bind request change button
-        const requestBtn = container.querySelector('.rs-request-change-btn');
-        if (requestBtn) {
-            const transitions = getValidTransitions(currentStatus);
-            if (transitions.length === 0) {
-                requestBtn.disabled = true;
-                requestBtn.title = 'No valid transitions from current status';
-            } else {
-                requestBtn.addEventListener('click', () => {
-                    showRequestForm(container, reqId, currentStatus);
-                });
-            }
-        }
-
-        // Bind package toggle button
-        const packageToggleBtn = container.querySelector('.rs-package-toggle');
-        if (packageToggleBtn) {
-            packageToggleBtn.addEventListener('click', async () => {
-                packageToggleBtn.disabled = true;
-                const originalText = packageToggleBtn.textContent;
-                packageToggleBtn.textContent = 'Updating...';
-
-                const inPackage = isReqInActivePackage(reqId);
-                let result;
-
-                if (inPackage) {
-                    // Remove from active package
-                    const packageId = review.packages.activeId;
-                    result = await review.removeReqFromPackage(packageId, reqId);
-                } else {
-                    // Add to active package (or default if none active)
-                    result = await review.addReqToActivePackage(reqId);
-                }
-
-                if (result && result.success) {
-                    // Re-render the panel to update button state
-                    renderStatusPanel(container, reqId, currentStatus);
-                } else {
-                    packageToggleBtn.disabled = false;
-                    packageToggleBtn.textContent = originalText;
-                    alert('Failed to update package: ' + (result?.error || 'Unknown error'));
-                }
-            });
-        }
-    }
-    review.renderStatusPanel = renderStatusPanel;
-
-    /**
-     * Show request form
-     * @param {Element} container - Container element
-     * @param {string} reqId - Requirement ID
-     * @param {string} currentStatus - Current status
-     */
-    function showRequestForm(container, reqId, currentStatus) {
-        // Remove existing form
-        let form = container.querySelector('.rs-request-form');
-        if (form) form.remove();
-
-        container.insertAdjacentHTML('afterbegin', requestFormTemplate(reqId, currentStatus));
-        form = container.querySelector('.rs-request-form');
-
-        // Update approvers display on status change
-        const newStatus = form.querySelector('.rs-new-status');
-        const approversDisplay = form.querySelector('.rs-approvers-display');
-
-        function updateApprovers() {
-            const toStatus = newStatus.value;
-            const approvers = review.state.config.getRequiredApprovers(currentStatus, toStatus);
-            approversDisplay.textContent = approvers.join(', ');
-        }
-        updateApprovers();
-        newStatus.addEventListener('change', updateApprovers);
-
-        // Submit handler
-        form.querySelector('.rs-submit-request').addEventListener('click', () => {
-            submitStatusRequest(form, reqId, currentStatus);
-        });
-
-        // Cancel handler
-        form.querySelector('.rs-cancel-request').addEventListener('click', () => {
-            form.remove();
-        });
-
-        // Focus justification
-        form.querySelector('.rs-justification').focus();
-    }
-    review.showRequestForm = showRequestForm;
-
-    /**
-     * Submit status change request
-     * @param {Element} form - Form element
-     * @param {string} reqId - Requirement ID
-     * @param {string} currentStatus - Current status
-     */
-    function submitStatusRequest(form, reqId, currentStatus) {
-        const newStatus = form.querySelector('.rs-new-status').value;
-        const justification = form.querySelector('.rs-justification').value.trim();
-
-        if (!justification) {
-            alert('Please provide a justification');
-            return;
-        }
-
-        const user = review.state.currentUser || 'anonymous';
-        const approvers = review.state.config.getRequiredApprovers(currentStatus, newStatus);
-
-        // Create request
-        const request = review.StatusRequest.create(
-            reqId, currentStatus, newStatus, user, justification, approvers
-        );
-        review.state.addRequest(request);
-
-        // Trigger event
-        document.dispatchEvent(new CustomEvent('traceview:request-created', {
-            detail: { request, reqId }
-        }));
-
-        // Re-render
-        const panel = form.closest('.rs-status-panel');
-        if (panel) {
-            renderStatusPanel(panel.parentElement, reqId, currentStatus);
-        } else {
-            form.remove();
-        }
-    }
-
-    /**
-     * Bind event handlers to request elements
-     * @param {Element} container - Container element
-     */
-    function bindRequestEvents(container) {
-        // Approve buttons
-        container.querySelectorAll('.rs-approve-btn').forEach(btn => {
-            btn.addEventListener('click', () => {
-                const card = btn.closest('.rs-request-card');
-                submitApproval(card, container, 'approve');
-            });
-        });
-
-        // Reject buttons
-        container.querySelectorAll('.rs-reject-btn').forEach(btn => {
-            btn.addEventListener('click', () => {
-                const card = btn.closest('.rs-request-card');
-                submitApproval(card, container, 'reject');
-            });
-        });
-    }
-
-    /**
-     * Submit approval/rejection
-     * @param {Element} card - Request card element
-     * @param {Element} container - Container element
-     * @param {string} decision - 'approve' or 'reject'
-     */
-    function submitApproval(card, container, decision) {
-        const requestId = card.getAttribute('data-request-id');
-        const comment = card.querySelector('.rs-approval-comment')?.value || '';
-        const user = review.state.currentUser;
-        const reqId = container.querySelector('[data-req-id]')?.getAttribute('data-req-id') ||
-                      container.closest('[data-req-id]')?.getAttribute('data-req-id');
-
-        if (!user) {
-            alert('Please set your username first');
-            return;
-        }
-
-        if (reqId) {
-            const requests = review.state.getRequests(reqId);
-            const request = requests.find(r => r.requestId === requestId);
-            if (request) {
-                request.addApproval(user, decision, comment);
-
-                // Trigger event
-                document.dispatchEvent(new CustomEvent('traceview:approval-added', {
-                    detail: { request, reqId, user, decision }
-                }));
-
-                // Get current status from display
-                const currentStatus = container.querySelector('.rs-current-status strong')?.textContent || 'Draft';
-
-                // Re-render
-                renderStatusPanel(container.parentElement || container, reqId, currentStatus);
-            }
-        }
-    }
-
-    /**
-     * Get pending request count for a requirement
-     * @param {string} reqId - Requirement ID
-     * @returns {number} Count of pending requests
-     */
-    function getPendingRequestCount(reqId) {
-        const requests = review.state.getRequests(reqId);
-        return requests.filter(r => r.state === review.RequestState.PENDING).length;
-    }
-    review.getPendingRequestCount = getPendingRequestCount;
-
-    /**
-     * Create status badge for display in REQ list
-     * @param {string} reqId - Requirement ID
-     * @returns {string} HTML for badge or empty string
-     */
-    function createStatusBadge(reqId) {
-        const pending = getPendingRequestCount(reqId);
-        if (pending === 0) return '';
-
-        return `<span class="rs-badge rs-badge-pending" title="${pending} pending status request(s)">
-            [P] ${pending}
-        </span>`;
-    }
-    review.createStatusBadge = createStatusBadge;
-
-    // ==========================================================================
-    // Review Panel Integration
-    // ==========================================================================
-
-    /**
-     * Handle review panel ready event - add status section
-     * @param {CustomEvent} event - Event with reqId, req, and sectionsContainer
-     */
-    function handleReviewPanelReady(event) {
-        const { reqId, req, sectionsContainer } = event.detail;
-        if (!sectionsContainer) return;
-
-        // Get current status from requirement data
-        const currentStatus = req ? req.status : 'Draft';
-
-        // Create status section
-        const statusSection = document.createElement('div');
-        statusSection.className = 'rs-status-section';
-        statusSection.setAttribute('data-req-id', reqId);
-        sectionsContainer.appendChild(statusSection);
-
-        // Render status panel
-        renderStatusPanel(statusSection, reqId, currentStatus);
-    }
-
-    // Register event listener
-    document.addEventListener('traceview:review-panel-ready', handleReviewPanelReady);
-
-})(TraceView.review);