SideButton Marketing Website Knowledge Pack Files

Prerequisites

• Authenticated session
• At least one online agent
• Cookie consent dismissed

Phase 1: Page Load & Structure

#	Test	Method	Pass Criteria
1.1	Queue page loads	navigate to /portal/queue	H1 "Dispatch Queue" visible
1.2	Item count format	snapshot	"N items" text below heading (simple count, no breakdown)
1.3	Add Item button	snapshot	button "+ Add Item" in top-right, blue outlined
1.4	Cancel All button (with items)	snapshot (when items exist)	button "Cancel All" in red text, next to Add Item. NOT rendered when queue is empty
1.5	Filter tabs	snapshot	All 6 tabs: All, Waiting, Queued (N), Dispatched, Failed, Cancelled
1.6	All tab active	snapshot	"All" tab has green pill background (bg-emerald-500/20) by default
1.7	Queued tab count	snapshot	"Queued" tab shows count in parentheses when items exist, e.g. "Queued (4)". Shows plain "Queued" with no count when 0
1.8	Search box	snapshot	textbox "Search tickets…" visible below filter tabs
1.9	Workflow filter	snapshot	combobox labeled "Workflow" with "All workflows" default
1.10	No Agent filter in list header	snapshot	Agent filter dropdown is NOT present in list header (only Workflow filter)
1.11	Column headers	snapshot	Three columns: "Item", "Agent", "Status"
1.12	Sidebar active	snapshot	"Queue" link active in sidebar navigation

Phase 2: Queue Item Row Structure

#	Test	Method	Pass Criteria
2.1	Item ID	snapshot	Queue ID visible as "#N" (e.g., "#1242")
2.2	Role badge	snapshot	Uppercase role badge (QA/SE/SD/PM/OPS) with correct color
2.3	Role badge colors	screenshot	QA=purple, SE=blue, SD/PM/OPS=slate
2.4	Workflow name	snapshot	Workflow display name (e.g., "QA-Regression", "SE Work")
2.5	Effort badge	snapshot	Uppercase effort badge (HIGH/MAX/MEDIUM)
2.6	Effort badge colors	screenshot	MAX=red, HIGH=orange, MEDIUM=slate
2.7	Job link	snapshot	"Job #N" link on dispatched/completed items, links to /portal/jobs/{id}
2.8	Agent avatar + name	snapshot	Agent avatar image + name link (links to /portal/agents)
2.9	Auto-picked prefix	snapshot	Auto-assigned agents show "Auto-picked: {agent-name}"
2.10	Status badge	snapshot	Colored status pill (Completed/Queued/Dispatched/Failed/Cancelled)
2.11	Relative timestamp	snapshot	Time ago text (e.g., "22m ago", "1h ago", "2d ago")
2.12	Ticket URL link	snapshot	Ticket reference shown as clickable link (Jira key or full URL)
2.13	Pulsing dot	screenshot	Queued/dispatched items show pulsing dot indicator on left

Phase 3: Empty State

#	Test	Method	Pass Criteria
3.1	Empty queue icon	snapshot (when empty)	Queue icon centered in content area
3.2	Empty queue text (All tab)	snapshot on All tab	"Queue is empty" heading
3.3	Empty queue hint	snapshot	'Click "+ Add Item" or paste batch Jira tickets in Chat'
3.4	Empty state (Dispatched tab)	navigate ?status=dispatched → snapshot	"No dispatched items" text
3.5	Empty state (Failed tab)	navigate ?status=failed → snapshot	"No failed items" text
3.6	Empty state (Cancelled tab)	navigate ?status=cancelled → snapshot	"No cancelled items" text
3.7	Empty state (Waiting tab)	navigate ?status=waiting → snapshot	"No waiting items" text
3.8	Empty state (Queued tab)	navigate ?status=queued → snapshot	"No queued items" text
3.9	Cancel All hidden when empty	snapshot (empty queue)	button "Cancel All" is NOT present in DOM

Phase 4: Add Item Form

#	Test	Method	Pass Criteria
4.1	Open form	click "+ Add Item" → snapshot	"Add to Queue" heading visible, form panel above filter tabs
4.2	Close form (X)	click X button → snapshot	Form panel hidden
4.3	Toggle form	click "+ Add Item" twice → snapshot	Form opens then closes
4.4	Ticket URL field	snapshot	textbox with placeholder "SCRUM-42 or https://...atlassian.net/browse/SCRUM-42"
4.5	Hint field	snapshot	Optional textbox labeled "Hint (optional)", placeholder "Extra instructions for the agent, e.g. focus on login module, skip tests..."
4.6	Workflow dropdown default	snapshot combobox	Default "— Select Workflow —" (no pre-selection)
4.7	Workflow options list	evaluate JS to list options	12 workflows + placeholder: pm-drive, pm-sprint, pull-repos, qa-followup, qa-new-ticket, qa-regression, qa-validate, sd-coverage, se-followup, se-rca, se-rca-fix, se-work
4.8	All workflow types present	evaluate JS	PM, OPS, QA, SD, SE workflows all available in dropdown (not limited to SE/QA)
4.8b	Workflow display text	snapshot combobox options	Options show full description text (e.g. "Read ticket, understand context, implement fix, create PR, report back") not short names
4.9	Agent dropdown default	snapshot combobox	"Auto-assign" default
4.10	Agent options list	evaluate JS	Lists all agents with status and roles, e.g. "venmate-agent-1 (online — se, qa, sd, pm)"
4.11	Effort dropdown default	snapshot combobox	Default follows account's Default Effort Level from Settings > General (currently "Medium (Sonnet)" — NOT hardcoded to "High (Opus)")
4.12	Effort options	evaluate JS	3 options: Medium (Sonnet), High (Opus), Max (Opus)
4.13	10s delay note	snapshot	"Item will wait 10s before entering the dispatch queue" text visible
4.14	Add to Queue button	snapshot	Cyan button "Add to Queue"
4.15	Form field order	screenshot	Top-to-bottom: Ticket URL → Hint → Workflow → Agent + Effort (side by side) → delay note + submit
4.16	Entry Path hidden by default	evaluate JS	select with name "form-entry-path" exists but parent is display: none with 0 options

Phase 5: Add Item & State Transitions

#	Test	Method	Pass Criteria
5.1	Submit with ticket	select workflow + fill Ticket URL + click "Add to Queue" → snapshot	Item appears in list with "Waiting" status
5.2	Waiting → Queued	wait 10s → snapshot	Item transitions from "Waiting" to "Queued"
5.3	Queued → Dispatched	wait for agent pickup → snapshot	Item transitions to "Dispatched", linked to job
5.4	Item count updates	snapshot heading area	Item count increases after adding
5.5	Change workflow	select different workflow → snapshot	Dropdown updates to new selection
5.6	Change effort	select "Max (Opus)" → snapshot	Effort dropdown shows new selection
5.7	Select specific agent	select agent from dropdown → snapshot	Agent dropdown shows agent name with status
5.8	Add with hint	fill Hint field + submit → snapshot	Item queued with hint

Phase 6: Filter Tabs

#	Test	Method	Pass Criteria
6.1	Filter: Waiting	click "Waiting" → snapshot	Only waiting items shown, URL has ?status=waiting
6.2	Filter: Queued	click "Queued" → snapshot	Only queued items shown, tab has green pill
6.3	Filter: Dispatched	click "Dispatched" → snapshot	Only dispatched items shown
6.4	Filter: Failed	click "Failed" → snapshot	Only failed items shown
6.5	Filter: Cancelled	click "Cancelled" → snapshot	Only cancelled items shown
6.6	Filter: All	click "All" → snapshot	All items shown, URL is /portal/queue
6.7	Filter with no matches	filter to status with 0 items → snapshot	Context-sensitive empty text: "No {status} items" (e.g. "No dispatched items")
6.8	Active tab styling	screenshot after clicking tab	Active tab has green pill (bg-emerald-500/20), others are slate text

Phase 7: Search & Workflow Filter

#	Test	Method	Pass Criteria
7.1	Search by ticket key	type "SCRUM-" in search box → snapshot	List filters to items with matching ticket references
7.2	Search clear	clear search box → snapshot	Full list restored
7.3	Workflow filter	select a workflow from Workflow dropdown → snapshot	List shows only items with that workflow
7.4	Workflow filter shows descriptions	snapshot Workflow filter options	Options display full workflow descriptions (same as form dropdown)
7.5	Combined filters	set status tab + workflow filter → snapshot	Both filters applied simultaneously
7.6	Reset Workflow filter	select "All workflows" → snapshot	Filter removed, all workflows shown

Phase 8: Item Actions

#	Test	Method	Pass Criteria
8.1	Cancel queued item	on Queued item, click "Cancel" → snapshot	Item moves to "Cancelled" status
8.2	Dispatch Now	on Queued item, click "Dispatch Now" → snapshot	Item dispatches immediately (skips waiting)
8.3	Resend cancelled item	on Cancelled item, click "Resend" → snapshot	New queue item created
8.4	Resend dispatched item	on Dispatched item, click "Resend" → snapshot	New queue item created
8.5	Retry failed item	on Failed item, click "Retry" → snapshot	Same dispatch retried
8.6	Resend failed item	on Failed item, click "Resend" → snapshot	New queue item created
8.7	No actions on completed	snapshot completed item	No Cancel/Resend/Retry buttons visible
8.8	Cancel All	click "Cancel All" (when items exist) → snapshot	All queued/waiting items cancelled. Button disappears after all items cancelled
8.9	Failed error message	snapshot failed item	Inline error text visible (e.g., "FOREIGN KEY constraint failed")

Phase 9: Item Links & Navigation

#	Test	Method	Pass Criteria
9.1	Job link navigation	click "Job #N" link → verify URL	Navigates to /portal/jobs/{id}
9.2	Agent link navigation	click agent name link → verify URL	Navigates to /portal/agents
9.3	Ticket URL link	click ticket link (e.g., "SCRUM-229") → verify	Opens Jira URL in browser
9.4	Sidebar Queue link	snapshot sidebar	Queue link active with highlight background

Phase 10: Infinite Scroll & Pagination

#	Test	Method	Pass Criteria
10.1	Initial load count	evaluate JS to count items	~40 items loaded initially
10.2	Loading more text	scroll to bottom → snapshot	"Loading more..." text appears
10.3	More items loaded	wait after scroll → snapshot	Additional items appended to list
10.4	Item order	snapshot	Items sorted by newest first (highest ID at top)

Phase 11: Edge Cases

#	Test	Method	Pass Criteria
11.1	Submit without workflow	leave Workflow as "— Select Workflow —", click "Add to Queue"	Form validation prevents submission or shows error
11.2	Submit without ticket	leave Ticket URL empty, click "Add to Queue"	Verify behavior (may accept empty)
11.3	Invalid ticket format	enter "not-a-ticket" → submit	Verify behavior (may accept any string)
11.4	Add multiple items	add 3 items rapidly → snapshot	All 3 appear in list, correct order
11.5	Long hint text	enter very long hint → submit → snapshot	Hint accepted, item queued
11.6	Cancel All not rendered when empty	when queue is empty, snapshot	button "Cancel All" is NOT in DOM (not just disabled — absent)

Automation Tips

• All dropdowns (form: Workflow, Agent, Effort; list: Workflow filter) are native <select> elements — use select_option tool, not click
• Two Workflow dropdowns exist: form dropdown for adding items vs list header dropdown for filtering — both show description text and same workflow options
• Workflow dropdown values are short slugs (e.g. se-work, qa-validate, pm-drive), display text is the full workflow description
• Agent dropdown value is a numeric ID (e.g. "6864"), not the agent name. Agent filter is NOT present in list header
• The form panel toggles open/close — click "+ Add Item" again to close if already open, or use the X button
• State transitions (Waiting → Queued → Dispatched) happen server-side with delays — poll with snapshots
• The 10s waiting period is real — items don't immediately become "Queued"
• All workflow types (SE, QA, PM, SD, OPS) are now available in the queue Add Item form — no longer restricted to SE/QA only
• Failed items have BOTH "Retry" and "Resend" — test both paths
• Error messages on failed items appear as inline text (span element) within the item row
• "Cancel All" is destructive with no confirmation — use with caution in testing
• Infinite scroll loads more items on scroll — use scroll tool to trigger
• "Auto-picked:" prefix on agent names indicates the system chose the agent (auto-assign)
• Effort default follows account setting (currently "Medium (Sonnet)") — do NOT assume any hardcoded default
• Cancel All button is conditionally rendered — only visible when queue has items, hidden on empty queue
• Entry Path dropdown is hidden by default — only becomes visible when selected workflow defines entry paths
• Empty state text is context-sensitive — "Queue is empty" on All tab, "No {status} items" on filtered tabs