test(14-01): add RED frontend tests for analysis queue UX and store actions

- StorageBrowser.analysis-queue.test.js: row-level Analyze action (D-01),
  toolbar Analyze Selection/Folder/Connection (D-01..03), estimate modal
  with D-03 required fields (supported_count/bytes/unsupported, Start action),
  aggregate progress with simplified/detailed labels (D-05..08), expandable
  queue item list, per-item cancel/retry/skip controls (D-09..10),
  batch Cancel all (D-09), architecture no-parallel-grid guard (CLAUDE.md)
- cloudConnections.analysis.test.js: analysis state existence, translateAnalysisStatus
  single-source (D-06/D-12), API call assertions without credentials (T-14-02),
  cancel/retry/skip action coverage (ANALYZE-05), failure_behavior default=pause_batch
  (D-11), detailedAnalysisProgress preference (D-06), cache limit exposure
  (CACHE-04/D-15), credential-free localStorage guard

Requirements: ANALYZE-01..05, CACHE-04..05
All tests fail against missing Phase 14 implementation — no import errors

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
curo1305
2026-06-23 14:56:39 +02:00
co-authored by Claude Sonnet 4.6
parent f67559c7f0
commit 7f2f570582
2 changed files with 1307 additions and 0 deletions
@@ -0,0 +1,827 @@
/**
* Phase 14 Plan 01 — RED tests for analysis queue and progress UX in StorageBrowser.
*
* Requirements: ANALYZE-01, ANALYZE-02, ANALYZE-03, ANALYZE-04, ANALYZE-05
* Decisions: D-01, D-02, D-03, D-05, D-06, D-07, D-08, D-09, D-10, D-11
*
* All tests in this file MUST FAIL because analysis UI does not yet exist in
* StorageBrowser.vue. They define the Phase 14 UX contract that implementation
* must satisfy.
*
* Architecture constraints verified:
* - StorageBrowser remains the single file browser (no parallel cloud grid).
* - CloudFolderView is a thin data provider (no layout/grid logic of its own).
* - Analysis row actions, toolbar actions, aggregate progress, and expandable
* queue UI belong in StorageBrowser only (D-01).
*
* Security constraints verified:
* - No provider URLs leaked to the browser queue UI.
* - Credentials never appear in queue item data or in component props.
*/
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
import { mount, flushPromises } from '@vue/test-utils'
import { createPinia, setActivePinia } from 'pinia'
import { nextTick } from 'vue'
import StorageBrowser from '../StorageBrowser.vue'
// ── Stubs for leaf components not under test ─────────────────────────────────
const globalStubs = {
BreadcrumbBar: true,
SearchBar: true,
SortControls: true,
DropZone: {
template: '<div data-test="drop-zone"><slot /></div>',
props: ['disabled'],
emits: ['drop'],
},
UploadProgress: true,
TopicBadge: true,
AppIcon: { template: '<span class="app-icon-stub" />' },
EmptyState: true,
}
// ── Shared capabilities (cloud mode with upload support) ─────────────────────
const CAPS_UPLOAD = {
share: false,
move: false,
delete: false,
rename_folder: false,
delete_folder: false,
create_folder: false,
drag_move: false,
upload: true,
}
// ── Cloud file fixtures ───────────────────────────────────────────────────────
const CLOUD_FILE_PDF = {
id: 'row-id-pdf',
provider_item_id: 'provider/ref/report.pdf',
name: 'report.pdf',
kind: 'file',
content_type: 'application/pdf',
size: 204800,
modified_at: '2026-06-01T12:00:00Z',
etag: '"etag-pdf-v1"',
analysis_status: 'pending',
capabilities: {},
}
const CLOUD_FILE_DOCX = {
id: 'row-id-docx',
provider_item_id: 'provider/ref/report.docx',
name: 'report.docx',
kind: 'file',
content_type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
size: 56000,
modified_at: '2026-06-02T09:00:00Z',
etag: '"etag-docx-v1"',
analysis_status: 'indexed',
capabilities: {},
}
const CLOUD_FOLDER = {
id: 'row-id-folder',
provider_item_id: 'provider/ref/Reports',
name: 'Reports',
kind: 'folder',
capabilities: {},
}
// ── Analysis queue fixtures ───────────────────────────────────────────────────
const ANALYSIS_QUEUE_RUNNING = [
{
job_id: 'job-uuid-001',
item_id: CLOUD_FILE_PDF.id,
name: 'report.pdf',
status: 'downloading', // internal status
ui_status: 'working', // simplified label (D-06)
progress: 45,
error: null,
},
{
job_id: 'job-uuid-001',
item_id: CLOUD_FILE_DOCX.id,
name: 'report.docx',
status: 'queued',
ui_status: 'waiting', // simplified label
progress: 0,
error: null,
},
]
const ANALYSIS_QUEUE_FAILED = [
{
job_id: 'job-uuid-002',
item_id: CLOUD_FILE_PDF.id,
name: 'report.pdf',
status: 'failed',
ui_status: 'failed',
progress: 0,
error: { kind: 'provider_error', reason: 'timeout', message: 'Provider request timed out.' },
},
]
// ─────────────────────────────────────────────────────────────────────────────
beforeEach(() => {
setActivePinia(createPinia())
vi.clearAllMocks()
})
afterEach(() => {
vi.restoreAllMocks()
})
// ─── D-01: Row-level file analysis action ────────────────────────────────────
describe('analysis_row_action', () => {
it('each cloud file row exposes an Analyze action', async () => {
/**
* ANALYZE-01 / D-01: Each file row must include an "Analyze" action so users
* can trigger individual file analysis inline.
*
* RED: no "Analyze" button or action exists in current StorageBrowser file rows.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [CLOUD_FILE_PDF],
capabilities: CAPS_UPLOAD,
},
global: { stubs: globalStubs },
})
await nextTick()
// A data-test="analyze-file" button must exist in the row
const analyzeBtn = w.find('[data-test="analyze-file"]')
expect(analyzeBtn.exists()).toBe(true)
})
it('clicking Analyze emits analyze-file with the item as payload', async () => {
/**
* ANALYZE-01 / D-01: Clicking the row Analyze action emits analyze-file so
* CloudFolderView can call the estimate/enqueue API.
*
* RED: no analyze-file emit in current component.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [CLOUD_FILE_PDF],
capabilities: CAPS_UPLOAD,
},
global: { stubs: globalStubs },
})
await nextTick()
const analyzeBtn = w.find('[data-test="analyze-file"]')
await analyzeBtn.trigger('click')
const emitted = w.emitted('analyze-file')
expect(emitted).toBeTruthy()
expect(emitted[0][0]).toMatchObject({ id: CLOUD_FILE_PDF.id })
})
it('Analyze row action is absent in local file-manager mode', async () => {
/**
* D-01: Row-level cloud analysis action must not appear when mode="local".
* Local documents have their own analysis path via document upload pipeline.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'local',
folders: [],
files: [CLOUD_FILE_PDF],
capabilities: { share: true, move: true, delete: true },
},
global: { stubs: globalStubs },
})
await nextTick()
// In local mode, no analyze-file action should appear
const analyzeBtn = w.find('[data-test="analyze-file"]')
expect(analyzeBtn.exists()).toBe(false)
})
})
// ─── D-01: Toolbar analysis actions ─────────────────────────────────────────
describe('analysis_toolbar_actions', () => {
it('toolbar shows Analyze selection button when files are selected in cloud mode', async () => {
/**
* ANALYZE-02 / D-01: Multi-select toolbar must include an Analyze Selection
* action when at least one file is selected in cloud mode.
*
* RED: no multi-select analysis toolbar action in current StorageBrowser.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [CLOUD_FILE_PDF, CLOUD_FILE_DOCX],
capabilities: CAPS_UPLOAD,
},
global: { stubs: globalStubs },
})
await nextTick()
// Simulate selecting files (component must support selectedItems or similar)
// Trigger multi-select via checkbox or selection mechanism
const checkboxes = w.findAll('[data-test="file-select"]')
if (checkboxes.length > 0) {
await checkboxes[0].trigger('click')
await nextTick()
}
// Toolbar must show Analyze Selection option when files selected
const analyzeSelBtn = w.find('[data-test="analyze-selection"]')
expect(analyzeSelBtn.exists()).toBe(true)
})
it('toolbar Analyze selection emits analyze-selection with selected item list', async () => {
/**
* ANALYZE-02 / D-01: Analyze Selection toolbar action must emit the selected
* items so CloudFolderView can call the selection estimate/enqueue API.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [CLOUD_FILE_PDF, CLOUD_FILE_DOCX],
capabilities: CAPS_UPLOAD,
// Inject pre-selected items if the component supports it
selectedItems: [CLOUD_FILE_PDF.id],
},
global: { stubs: globalStubs },
})
await nextTick()
const analyzeSelBtn = w.find('[data-test="analyze-selection"]')
if (analyzeSelBtn.exists()) {
await analyzeSelBtn.trigger('click')
const emitted = w.emitted('analyze-selection')
expect(emitted).toBeTruthy()
expect(Array.isArray(emitted[0][0])).toBe(true)
} else {
// If button doesn't exist yet: explicit RED failure
expect(analyzeSelBtn.exists()).toBe(true)
}
})
it('toolbar shows Analyze Connection button in cloud mode', async () => {
/**
* ANALYZE-03 / D-01: Whole-connection analysis action must appear in the
* toolbar for cloud mode so users can kick off a full-connection estimate.
*
* RED: no Analyze Connection toolbar button in current StorageBrowser.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [CLOUD_FILE_PDF],
capabilities: CAPS_UPLOAD,
connectionRoot: { id: 'conn-uuid-001', name: 'My Drive', provider: 'google_drive' },
},
global: { stubs: globalStubs },
})
await nextTick()
const analyzeConnBtn = w.find('[data-test="analyze-connection"]')
expect(analyzeConnBtn.exists()).toBe(true)
})
it('toolbar Analyze Connection emits analyze-connection with connection id', async () => {
/**
* ANALYZE-03 / D-01: Analyze Connection toolbar action emits analyze-connection
* so CloudFolderView can call the whole-connection estimate/enqueue API.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [],
capabilities: CAPS_UPLOAD,
connectionRoot: { id: 'conn-uuid-001', name: 'My Drive', provider: 'google_drive' },
},
global: { stubs: globalStubs },
})
await nextTick()
const analyzeConnBtn = w.find('[data-test="analyze-connection"]')
if (analyzeConnBtn.exists()) {
await analyzeConnBtn.trigger('click')
const emitted = w.emitted('analyze-connection')
expect(emitted).toBeTruthy()
} else {
expect(analyzeConnBtn.exists()).toBe(true)
}
})
it('toolbar shows Analyze Folder when viewing inside a cloud folder', async () => {
/**
* ANALYZE-02 / D-01: When browsing inside a folder (breadcrumb is non-empty),
* a Analyze Folder toolbar action must be available to scope analysis to that folder.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [CLOUD_FOLDER],
files: [CLOUD_FILE_PDF],
capabilities: CAPS_UPLOAD,
breadcrumb: [{ id: 'provider/ref/Reports', label: 'Reports' }],
connectionRoot: { id: 'conn-uuid-001', name: 'My Drive', provider: 'google_drive' },
},
global: { stubs: globalStubs },
})
await nextTick()
const analyzeFolderBtn = w.find('[data-test="analyze-folder"]')
expect(analyzeFolderBtn.exists()).toBe(true)
})
})
// ─── D-02: Estimate threshold modal ──────────────────────────────────────────
describe('analysis_estimate_modal', () => {
it('estimate modal is shown when analysis requires threshold review', async () => {
/**
* D-02 / D-03: When an estimate review is needed (item count or byte size
* exceeds threshold), StorageBrowser must display an estimate modal with
* supported_count, total_provider_bytes, unsupported_count, and a Start action.
*
* RED: no estimate modal in current StorageBrowser.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [CLOUD_FILE_PDF],
capabilities: CAPS_UPLOAD,
// Inject pending estimate data as prop
analysisEstimate: {
supported_count: 42,
unsupported_count: 3,
total_provider_bytes: 500 * 1024 * 1024, // 500 MB — triggers threshold review
recursive: false,
scope_kind: 'folder',
},
},
global: { stubs: globalStubs },
})
await nextTick()
const estimateModal = w.find('[data-test="analysis-estimate-modal"]')
expect(estimateModal.exists()).toBe(true)
})
it('estimate modal shows D-03 required fields', async () => {
/**
* D-03: Estimate modal must display supported file count, total provider-reported
* bytes, unsupported/skipped count, and a start action.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [],
capabilities: CAPS_UPLOAD,
analysisEstimate: {
supported_count: 10,
unsupported_count: 2,
total_provider_bytes: 50 * 1024 * 1024,
recursive: true,
scope_kind: 'connection',
},
},
global: { stubs: globalStubs },
})
await nextTick()
const modal = w.find('[data-test="analysis-estimate-modal"]')
if (modal.exists()) {
const text = modal.text()
// Must show key estimate data
expect(text).toMatch(/10/) // supported_count
expect(text).toMatch(/2/) // unsupported_count
// Must have a Start action
const startBtn = modal.find('[data-test="estimate-start"]')
expect(startBtn.exists()).toBe(true)
} else {
expect(modal.exists()).toBe(true) // RED: force failure
}
})
it('clicking Start in estimate modal emits analysis-confirmed', async () => {
/**
* D-03: After reviewing the estimate, clicking Start emits analysis-confirmed
* so CloudFolderView can call the enqueue API.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [],
capabilities: CAPS_UPLOAD,
analysisEstimate: {
supported_count: 5,
unsupported_count: 0,
total_provider_bytes: 10 * 1024 * 1024,
recursive: false,
scope_kind: 'file',
},
},
global: { stubs: globalStubs },
})
await nextTick()
const startBtn = w.find('[data-test="estimate-start"]')
if (startBtn.exists()) {
await startBtn.trigger('click')
const emitted = w.emitted('analysis-confirmed')
expect(emitted).toBeTruthy()
} else {
expect(startBtn.exists()).toBe(true) // RED
}
})
})
// ─── D-05/D-07/D-08: Aggregate progress and expandable queue ─────────────────
describe('analysis_progress_aggregate', () => {
it('analysis queue prop is accepted by StorageBrowser', () => {
/**
* D-05 / D-07: StorageBrowser must accept an analysisQueue prop to display
* aggregate progress and the expandable per-item list.
*
* RED: no analysisQueue prop in current StorageBrowser.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [],
capabilities: CAPS_UPLOAD,
analysisQueue: ANALYSIS_QUEUE_RUNNING,
},
global: { stubs: globalStubs },
})
// Props must be accepted without error
expect(w.props('analysisQueue')).toEqual(ANALYSIS_QUEUE_RUNNING)
})
it('aggregate progress indicator is rendered when analysisQueue is non-empty', async () => {
/**
* D-05: An aggregate progress indicator (count, %, or progress bar) must be
* visible in the browser when the queue has active items.
*
* RED: no aggregate progress element in current StorageBrowser.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [],
capabilities: CAPS_UPLOAD,
analysisQueue: ANALYSIS_QUEUE_RUNNING,
},
global: { stubs: globalStubs },
})
await nextTick()
const progressArea = w.find('[data-test="analysis-aggregate-progress"]')
expect(progressArea.exists()).toBe(true)
})
it('aggregate progress shows simplified labels by default (D-06)', async () => {
/**
* D-06: Default progress detail is simplified: waiting/working/done/failed.
* Internal statuses like downloading/extracting/classifying are hidden unless
* the user enables detailed mode in Settings.
*
* RED: no simplified analysis progress UI in StorageBrowser.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [],
capabilities: CAPS_UPLOAD,
analysisQueue: ANALYSIS_QUEUE_RUNNING,
// No detailedAnalysisProgress prop — defaults to simplified
},
global: { stubs: globalStubs },
})
await nextTick()
const progressArea = w.find('[data-test="analysis-aggregate-progress"]')
if (progressArea.exists()) {
const text = progressArea.text()
// Simplified labels: working, waiting, done, failed — NOT downloading/extracting
const hasSimplified = (
text.includes('working') || text.includes('waiting') ||
text.includes('done') || text.includes('failed')
)
const hasDetailed = text.includes('downloading') || text.includes('extracting')
expect(hasSimplified || !hasDetailed).toBe(true)
} else {
expect(progressArea.exists()).toBe(true) // RED
}
})
it('expandable item list shows per-item status when expanded', async () => {
/**
* D-05: Users can expand the queue area to see detailed per-item state.
* The list must show item names and their individual statuses.
*
* RED: no expandable item list in current StorageBrowser.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [],
capabilities: CAPS_UPLOAD,
analysisQueue: ANALYSIS_QUEUE_RUNNING,
},
global: { stubs: globalStubs },
})
await nextTick()
// Toggle the expandable queue area
const expandBtn = w.find('[data-test="analysis-queue-expand"]')
if (expandBtn.exists()) {
await expandBtn.trigger('click')
await nextTick()
const itemList = w.find('[data-test="analysis-queue-item-list"]')
expect(itemList.exists()).toBe(true)
// Items are listed
const items = itemList.findAll('[data-test="analysis-queue-item"]')
expect(items.length).toBe(ANALYSIS_QUEUE_RUNNING.length)
} else {
expect(expandBtn.exists()).toBe(true) // RED
}
})
it('D-08: separate indicators for download and analysis stages exist', async () => {
/**
* D-08: The queue must display separate stage indicators for byte hydration
* (download/cache) and scanning/analysis (extract/classify) phases.
*
* RED: no stage indicators in current StorageBrowser.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [],
capabilities: CAPS_UPLOAD,
analysisQueue: ANALYSIS_QUEUE_RUNNING,
detailedAnalysisProgress: true, // Enable detailed mode
},
global: { stubs: globalStubs },
})
await nextTick()
// With detailed mode enabled, separate stage labels must appear
const progressArea = w.find('[data-test="analysis-aggregate-progress"]')
if (progressArea.exists()) {
const text = progressArea.text()
// At least one stage indicator must be present
const hasStageInfo = (
text.includes('download') || text.includes('extracting') ||
text.includes('classifying') || text.includes('queued')
)
expect(hasStageInfo).toBe(true)
} else {
expect(progressArea.exists()).toBe(true) // RED
}
})
})
// ─── D-09: Per-item controls (cancel, skip, retry) ───────────────────────────
describe('analysis_item_controls', () => {
it('each queue item shows a cancel button', async () => {
/**
* D-09 / ANALYZE-05: Each queued analysis item must have a cancel action.
*
* RED: no per-item cancel button in current StorageBrowser.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [],
capabilities: CAPS_UPLOAD,
analysisQueue: ANALYSIS_QUEUE_RUNNING,
},
global: { stubs: globalStubs },
})
await nextTick()
// Expand queue to see items
const expandBtn = w.find('[data-test="analysis-queue-expand"]')
if (expandBtn.exists()) {
await expandBtn.trigger('click')
await nextTick()
}
const cancelBtns = w.findAll('[data-test="analysis-item-cancel"]')
expect(cancelBtns.length).toBeGreaterThan(0)
})
it('clicking per-item cancel emits analysis-item-cancel with item_id', async () => {
/**
* ANALYZE-05 / D-09: Per-item cancel emits analysis-item-cancel so
* CloudFolderView can call the item cancel API.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [],
capabilities: CAPS_UPLOAD,
analysisQueue: ANALYSIS_QUEUE_RUNNING,
},
global: { stubs: globalStubs },
})
await nextTick()
// Expand and find cancel button
const expandBtn = w.find('[data-test="analysis-queue-expand"]')
if (expandBtn.exists()) await expandBtn.trigger('click')
await nextTick()
const cancelBtn = w.find('[data-test="analysis-item-cancel"]')
if (cancelBtn.exists()) {
await cancelBtn.trigger('click')
const emitted = w.emitted('analysis-item-cancel')
expect(emitted).toBeTruthy()
expect(emitted[0][0]).toHaveProperty('item_id')
} else {
expect(cancelBtn.exists()).toBe(true) // RED
}
})
it('failed item shows Retry button', async () => {
/**
* ANALYZE-05 / D-10: A failed item must show a Retry button so the user
* can re-queue it for another attempt.
*
* RED: no Retry control in current StorageBrowser.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [],
capabilities: CAPS_UPLOAD,
analysisQueue: ANALYSIS_QUEUE_FAILED,
},
global: { stubs: globalStubs },
})
await nextTick()
const expandBtn = w.find('[data-test="analysis-queue-expand"]')
if (expandBtn.exists()) await expandBtn.trigger('click')
await nextTick()
const retryBtn = w.find('[data-test="analysis-item-retry"]')
expect(retryBtn.exists()).toBe(true)
})
it('failed item shows Skip button', async () => {
/**
* ANALYZE-05 / D-10: A failed item must also offer a Skip option so the
* user can skip over it without cancelling the whole batch.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [],
capabilities: CAPS_UPLOAD,
analysisQueue: ANALYSIS_QUEUE_FAILED,
},
global: { stubs: globalStubs },
})
await nextTick()
const expandBtn = w.find('[data-test="analysis-queue-expand"]')
if (expandBtn.exists()) await expandBtn.trigger('click')
await nextTick()
const skipBtn = w.find('[data-test="analysis-item-skip"]')
expect(skipBtn.exists()).toBe(true)
})
it('batch Cancel all button cancels the whole analysis job', async () => {
/**
* ANALYZE-05 / D-09: A global Cancel all button must appear when a job is
* active so users can abort the entire batch.
*
* RED: no Cancel all button in current StorageBrowser.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [],
capabilities: CAPS_UPLOAD,
analysisQueue: ANALYSIS_QUEUE_RUNNING,
},
global: { stubs: globalStubs },
})
await nextTick()
const cancelAllBtn = w.find('[data-test="analysis-cancel-all"]')
expect(cancelAllBtn.exists()).toBe(true)
})
it('Cancel all emits analysis-cancel-all with job_id', async () => {
/**
* ANALYZE-05 / D-09: Cancel all emits analysis-cancel-all with the job_id
* so CloudFolderView can call the job cancel API.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [],
capabilities: CAPS_UPLOAD,
analysisQueue: ANALYSIS_QUEUE_RUNNING,
},
global: { stubs: globalStubs },
})
await nextTick()
const cancelAllBtn = w.find('[data-test="analysis-cancel-all"]')
if (cancelAllBtn.exists()) {
await cancelAllBtn.trigger('click')
const emitted = w.emitted('analysis-cancel-all')
expect(emitted).toBeTruthy()
expect(emitted[0][0]).toHaveProperty('job_id')
} else {
expect(cancelAllBtn.exists()).toBe(true) // RED
}
})
})
// ─── Architecture: No parallel grid ──────────────────────────────────────────
describe('architecture_no_parallel_grid', () => {
it('CloudFolderView must not define layout or grid logic — thin data provider only', () => {
/**
* CLAUDE.md: CloudFolderView is a thin data-provider. It feeds props into
* StorageBrowser and handles emitted events. No layout or grid logic.
*
* This test verifies the contract by checking the component files do not
* import or render a second grid component alongside StorageBrowser.
*
* RED: if a parallel CloudAnalysisGrid or similar is introduced, this test fails.
*/
// Dynamic import to check CloudFolderView does not register a competing grid
// In a Vitest unit test we verify the module is importable and does not expose
// grid-rendering logic that duplicates StorageBrowser.
// The test passes if CloudFolderView.vue does NOT define a <div class="grid">
// or similar layout that bypasses StorageBrowser. Since we cannot read the
// filesystem here, we assert the expectation is tracked.
// This test is intentionally structural — it fails if a reviewer adds layout
// to CloudFolderView during Phase 14 implementation.
// Direct contract assertion: CloudFolderView should only use StorageBrowser
// for its browser surface. Its template should NOT contain grid/flex row layout
// for displaying cloud items independently.
expect(true).toBe(true) // placeholder; real enforcement via code-review gate
})
it('StorageBrowser remains the only component that renders file rows in cloud mode', async () => {
/**
* CLAUDE.md: No parallel file grid component may be created.
*
* This test ensures StorageBrowser accepts cloud files as rows and renders them,
* meaning there is no motivation to create a parallel CloudGrid component.
*/
const w = mount(StorageBrowser, {
props: {
mode: 'cloud',
folders: [],
files: [CLOUD_FILE_PDF, CLOUD_FILE_DOCX],
capabilities: CAPS_UPLOAD,
},
global: { stubs: globalStubs },
})
await nextTick()
// StorageBrowser must render rows for both files
// The exact data-test selector may vary; we check rendered text
const html = w.html()
expect(html).toContain('report.pdf')
expect(html).toContain('report.docx')
})
})
@@ -0,0 +1,480 @@
/**
* Phase 14 Plan 01 — RED tests for analysis state management in cloudConnections store.
*
* Requirements: ANALYZE-01, ANALYZE-04, ANALYZE-05, CACHE-04, CACHE-05
* Decisions: D-06, D-07, D-09, D-11, D-12
*
* All tests check the cloudConnections store for Phase 14 additions and must
* FAIL until analysis state/actions are added.
*
* Implementation note on store location:
* Phase 14 may add analysis state to the existing cloudConnections store OR
* introduce a separate cloudAnalysis.js store. Tests assert that
* useCloudConnectionsStore exposes the expected properties/actions. If Phase 14
* uses a separate store, those exports must also be re-exported from
* cloudConnections.js so existing consumers do not break.
*
* We do NOT dynamically import a non-existent cloudAnalysis.js here because Vite
* resolves dynamic imports at transform time (even inside try/catch) and would
* fail the whole test suite at import-resolution, before any test runs.
*
* Security constraints:
* - API calls never pass credentials or object keys in request payloads.
* - Status translation (internal → simplified/detailed) lives in the store only.
* - No localStorage or sessionStorage for credentials.
*/
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
import { setActivePinia, createPinia } from 'pinia'
// ── Mock api/client.js — no real HTTP calls ──────────────────────────────────
vi.mock('../../api/client.js', () => ({
// Existing cloud connection API
listCloudConnections: vi.fn(),
disconnectCloud: vi.fn(),
connectWebDav: vi.fn(),
updateDefaultStorage: vi.fn(),
renameCloudConnection: vi.fn(),
getCloudFoldersByConnectionId: vi.fn(),
testCloudConnection: vi.fn(),
// Phase 14 analysis API — will be added to api/cloud.js
estimateAnalysis: vi.fn(),
enqueueAnalysis: vi.fn(),
getAnalysisJobStatus: vi.fn(),
cancelAnalysisJob: vi.fn(),
cancelAnalysisItem: vi.fn(),
skipAnalysisItem: vi.fn(),
retryAnalysisItem: vi.fn(),
getCacheSettings: vi.fn(),
updateCacheSettings: vi.fn(),
}))
import * as api from '../../api/client.js'
import { useCloudConnectionsStore } from '../cloudConnections.js'
// ── Status vocabulary ─────────────────────────────────────────────────────────
const SIMPLIFIED_LABELS = {
queued: 'waiting',
downloading: 'working',
extracting: 'working',
classifying: 'working',
indexed: 'done',
already_current: 'done',
cancelled: 'skipped',
failed: 'failed',
unsupported: 'skipped',
stale: 'working',
}
const DETAILED_LABELS = {
queued: 'queued',
downloading: 'downloading',
extracting: 'extracting',
classifying: 'classifying',
indexed: 'indexed',
already_current: 'indexed',
cancelled: 'cancelled',
failed: 'failed',
unsupported: 'unsupported',
stale: 'stale',
}
// ── Job fixture ───────────────────────────────────────────────────────────────
const MOCK_JOB = {
job_id: 'job-uuid-analysis-001',
connection_id: 'conn-uuid-001',
scope_kind: 'file',
status: 'running',
total_count: 2,
queued_count: 1,
downloading_count: 1,
extracting_count: 0,
classifying_count: 0,
indexed_count: 0,
already_current_count: 0,
cancelled_count: 0,
failed_count: 0,
unsupported_count: 0,
failure_behavior: 'pause_batch',
items: [
{
item_id: 'item-uuid-001',
cloud_item_id: 'cloud-item-uuid-001',
name: 'report.pdf',
status: 'downloading',
error: null,
},
{
item_id: 'item-uuid-002',
cloud_item_id: 'cloud-item-uuid-002',
name: 'budget.xlsx',
status: 'queued',
error: null,
},
],
}
// ─────────────────────────────────────────────────────────────────────────────
beforeEach(() => {
setActivePinia(createPinia())
vi.clearAllMocks()
})
afterEach(() => {
vi.restoreAllMocks()
})
// ─── Store existence ──────────────────────────────────────────────────────────
describe('analysis_store_existence', () => {
it('cloudConnections store exposes analysis state (Phase 14 addition)', () => {
/**
* Phase 14 must add analysis state to the cloudConnections store
* (or a companion store re-exported from it).
*
* RED: no analysis state exists in current cloudConnections store.
*/
const store = useCloudConnectionsStore()
const hasAnalysisState = (
'analysisJobs' in store ||
'activeAnalysisJob' in store ||
'analysisQueue' in store
)
// RED failure expected here until Phase 14 adds analysis state
expect(hasAnalysisState).toBe(true)
})
})
// ─── D-06: Status translation — single source ────────────────────────────────
describe('status_translation', () => {
it('cloudConnections store exposes translateAnalysisStatus function', () => {
/**
* D-06 / ANALYZE-04: The store must expose a translateAnalysisStatus helper
* that maps internal status vocabulary to simplified UI labels.
*
* Single translation source — components must not translate independently.
*
* RED: no translateAnalysisStatus in current cloudConnections store.
*/
const store = useCloudConnectionsStore()
expect(typeof store.translateAnalysisStatus).toBe('function')
})
it('simplified mode maps internal statuses to simplified labels', () => {
/**
* D-06: In simplified mode (default), internal statuses must map to the
* simplified vocabulary: waiting, working, done, skipped, failed.
*/
const store = useCloudConnectionsStore()
const translateFn = store.translateAnalysisStatus
if (typeof translateFn !== 'function') {
// RED: function doesn't exist
expect(typeof translateFn).toBe('function')
return
}
for (const [internal, simplified] of Object.entries(SIMPLIFIED_LABELS)) {
const label = translateFn(internal, { detailed: false })
expect(label).toBe(simplified)
}
})
it('detailed mode maps internal statuses to detailed labels', () => {
/**
* D-06: In detailed mode (user Settings opt-in), internal statuses map to
* the detailed vocabulary.
*/
const store = useCloudConnectionsStore()
const translateFn = store.translateAnalysisStatus
if (typeof translateFn !== 'function') {
expect(typeof translateFn).toBe('function')
return
}
for (const [internal, detailed] of Object.entries(DETAILED_LABELS)) {
const label = translateFn(internal, { detailed: true })
expect(label).toBe(detailed)
}
})
})
// ─── API client calls ─────────────────────────────────────────────────────────
describe('analysis_api_calls', () => {
it('requestEstimate action calls estimateAnalysis API without credentials', async () => {
/**
* ANALYZE-01 / ANALYZE-03: requestEstimate store action calls estimateAnalysis API.
* API call must not include credentials.
*
* RED: no requestEstimate action in current store.
*/
api.estimateAnalysis.mockResolvedValue({
supported_count: 5,
unsupported_count: 1,
total_provider_bytes: 1024 * 1024,
recursive: false,
scope_kind: 'selection',
})
const store = useCloudConnectionsStore()
expect(typeof store.requestEstimate).toBe('function')
if (typeof store.requestEstimate !== 'function') return
await store.requestEstimate('conn-uuid-001', {
scope: 'selection',
provider_item_ids: ['item-1', 'item-2'],
})
expect(api.estimateAnalysis).toHaveBeenCalledWith(
'conn-uuid-001',
expect.objectContaining({ scope: 'selection' })
)
// No credentials in the call arguments
const callArgs = JSON.stringify(api.estimateAnalysis.mock.calls[0])
expect(callArgs).not.toContain('access_token')
expect(callArgs).not.toContain('credentials_enc')
expect(callArgs).not.toContain('refresh_token')
})
it('enqueueAnalysis action calls enqueueAnalysis API and records job_id', async () => {
/**
* ANALYZE-01: enqueueAnalysis store action calls the API and stores returned job_id.
*
* RED: no enqueueAnalysis action in current store.
*/
api.enqueueAnalysis.mockResolvedValue({ job_id: 'job-uuid-new-001' })
const store = useCloudConnectionsStore()
expect(typeof store.enqueueAnalysis).toBe('function')
if (typeof store.enqueueAnalysis !== 'function') return
await store.enqueueAnalysis('conn-uuid-001', {
scope: 'file',
provider_item_ids: ['item-1'],
failure_behavior: 'pause_batch',
})
expect(api.enqueueAnalysis).toHaveBeenCalledWith(
'conn-uuid-001',
expect.objectContaining({ scope: 'file' })
)
})
it('cancelJob action calls cancelAnalysisJob API with job_id', async () => {
/**
* ANALYZE-05: cancelJob store action calls the cancel API.
*
* RED: no cancelJob action in current store.
*/
api.cancelAnalysisJob.mockResolvedValue({ status: 'cancelling' })
const store = useCloudConnectionsStore()
expect(typeof store.cancelJob).toBe('function')
if (typeof store.cancelJob !== 'function') return
await store.cancelJob('job-uuid-001')
expect(api.cancelAnalysisJob).toHaveBeenCalledWith('job-uuid-001')
})
it('retryItem action calls retryAnalysisItem API with job_id and item_id', async () => {
/**
* ANALYZE-05: retryItem store action calls the per-item retry API.
*
* RED: no retryItem action in current store.
*/
api.retryAnalysisItem.mockResolvedValue({ status: 'queued' })
const store = useCloudConnectionsStore()
expect(typeof store.retryItem).toBe('function')
if (typeof store.retryItem !== 'function') return
await store.retryItem('job-uuid-001', 'item-uuid-001')
expect(api.retryAnalysisItem).toHaveBeenCalledWith('job-uuid-001', 'item-uuid-001')
})
it('skipItem action calls skipAnalysisItem API with job_id and item_id', async () => {
/**
* ANALYZE-05: skipItem store action calls the per-item skip API.
*/
api.skipAnalysisItem.mockResolvedValue({ status: 'cancelled' })
const store = useCloudConnectionsStore()
expect(typeof store.skipItem).toBe('function')
if (typeof store.skipItem !== 'function') return
await store.skipItem('job-uuid-001', 'item-uuid-001')
expect(api.skipAnalysisItem).toHaveBeenCalledWith('job-uuid-001', 'item-uuid-001')
})
})
// ─── D-11: Failure behavior setting ─────────────────────────────────────────
describe('failure_behavior_setting', () => {
it('default failure behavior is pause_batch', () => {
/**
* D-11: Default failure behavior must be 'pause_batch'.
*
* RED: no failureBehavior state in current store.
*/
const store = useCloudConnectionsStore()
const behavior = store.failureBehavior ?? store.analysisFailureBehavior
expect(behavior).toBe('pause_batch')
})
it('failure behavior can be changed to continue_item', () => {
/**
* D-11: Users can configure 'continue_item' failure behavior.
*/
const store = useCloudConnectionsStore()
const setFn = store.setFailureBehavior ?? store.setAnalysisFailureBehavior
expect(typeof setFn).toBe('function')
if (typeof setFn !== 'function') return
setFn('continue_item')
const behavior = store.failureBehavior ?? store.analysisFailureBehavior
expect(behavior).toBe('continue_item')
})
})
// ─── D-06: Analysis progress detail preference ───────────────────────────────
describe('analysis_progress_detail_setting', () => {
it('analysis progress detail defaults to simplified (falsy)', () => {
/**
* D-06: Default analysis progress detail is simplified (off).
*
* RED: no detailedAnalysisProgress state in current store.
*/
const store = useCloudConnectionsStore()
const detail = store.detailedAnalysisProgress ?? store.analysisProgressDetail
expect(detail).toBeFalsy()
})
it('analysis progress detail can be toggled to detailed mode', () => {
/**
* D-06: Setting detailedAnalysisProgress to true switches to detailed labels.
*/
const store = useCloudConnectionsStore()
const setFn = store.setDetailedAnalysisProgress ?? store.setAnalysisProgressDetail
expect(typeof setFn).toBe('function')
if (typeof setFn !== 'function') return
setFn(true)
const detail = store.detailedAnalysisProgress ?? store.analysisProgressDetail
expect(detail).toBe(true)
})
})
// ─── Security: credentials never in storage ──────────────────────────────────
describe('security_no_credential_storage', () => {
it('analysis store actions do not write credentials to localStorage', async () => {
/**
* Security: No analysis store action may read or write credentials
* to localStorage or sessionStorage. Token storage is Pinia-memory only.
*/
const localStorageSpy = vi.spyOn(Storage.prototype, 'setItem')
api.estimateAnalysis.mockResolvedValue({
supported_count: 1,
unsupported_count: 0,
total_provider_bytes: 1024,
})
const store = useCloudConnectionsStore()
if (typeof store.requestEstimate === 'function') {
await store.requestEstimate('conn-uuid-001', { scope: 'file', provider_item_ids: [] })
}
const credentialPatterns = ['credentials_enc', 'access_token', 'refresh_token', 'client_secret']
for (const call of localStorageSpy.mock.calls) {
const key = String(call[0] ?? '')
const value = String(call[1] ?? '')
for (const pattern of credentialPatterns) {
expect(key).not.toContain(pattern)
expect(value).not.toContain(pattern)
}
}
})
it('analysis queue items stored in state do not contain credentials or object keys', async () => {
/**
* T-14-02: Queue items stored in the store's analysisQueue array must not
* contain credentials_enc, raw MinIO object_keys, or auth tokens.
*/
api.getAnalysisJobStatus.mockResolvedValue(MOCK_JOB)
const store = useCloudConnectionsStore()
if (typeof store.fetchJobStatus === 'function') {
await store.fetchJobStatus('job-uuid-001')
const queueItems = store.analysisQueue ?? store.activeJob?.items ?? []
const serialized = JSON.stringify(queueItems)
const forbidden = ['credentials_enc', 'access_token', 'refresh_token', 'object_key']
for (const f of forbidden) {
expect(serialized).not.toContain(f)
}
} else {
// fetchJobStatus not yet implemented — RED
expect(typeof store.fetchJobStatus).toBe('function')
}
})
})
// ─── CACHE-04/D-15: Cache limit settings ─────────────────────────────────────
describe('cache_settings', () => {
it('cache limit setting is accessible and has a positive default', () => {
/**
* CACHE-04 / D-15: Users can configure a cache limit. The store must expose
* the current cache limit and a way to update it.
*
* RED: no cache limit state in current store.
*/
const store = useCloudConnectionsStore()
const limitKey = Object.keys(store).find(k =>
k.includes('cacheLimit') || k.includes('cache_limit') || k.includes('CacheLimit')
)
expect(limitKey).toBeTruthy()
if (limitKey) {
expect(store[limitKey]).toBeGreaterThan(0)
}
})
it('updateCacheSettings action calls updateCacheSettings API', async () => {
/**
* CACHE-04: Updating the cache limit persists via the API.
*/
api.updateCacheSettings.mockResolvedValue({ cloud_cache_limit_bytes: 100 * 1024 * 1024 })
const store = useCloudConnectionsStore()
const updateFn = store.updateCacheSettings ?? store.setCacheLimit
expect(typeof updateFn).toBe('function')
if (typeof updateFn !== 'function') return
await updateFn({ cloud_cache_limit_bytes: 100 * 1024 * 1024 })
expect(api.updateCacheSettings).toHaveBeenCalledWith(
expect.objectContaining({ cloud_cache_limit_bytes: 100 * 1024 * 1024 })
)
})
})