Argus Auto Tagger

About

Argus Auto Tagger — Automatic Time Tracking for Amazon Associates

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎯 WHAT IT DOES

Argus Auto Tagger eliminates the need to manually punch time entries in Argus Time Tracker. It automatically detects which CP Central tab you're working on and punches the correct activity tag in Argus — instantly, accurately, and without interrupting your workflow.

Every time you switch between CP Central tabs, the extension reads the page content, determines the correct program (RP, PA, or CBC), identifies whether it's an ML or KW task, and punches the appropriate tag in Argus. No more alt-tabbing to Argus every few minutes. No more forgotten punches. No more inaccurate time logs.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚡ KEY FEATURES

▸ Automatic Tag Detection & Punching
  The extension monitors your active CP Central tab and automatically punches the correct Argus activity tag when you switch tasks. Supports all three CP Central URL types:
  
  • /class/ URLs — Reads the classification path directly from the URL
  • /artemis/ URLs — Reads the conversation text on the page to detect program and ML status
  • /annotator/audit/ URLs — Reads the page title to extract the classification path
  
  Detection includes retry logic (up to 20 attempts) to handle slow-loading pages.

▸ Smart Tag Mapping
  Automatically determines the correct tag based on program keywords and ML indicators:
  
  • RP / Rule Writing — Restricted Products (non-ML)
  • RP / Rule Writing - ML — Restricted Products (ML)
  • PA / Rule Writing - KW — Product Assurance / Product Safety / Food Safety (Keyword)
  • PA / Rule Writing - ML — Product Assurance (ML)
  • Cross Border / Rule Writing — CrossListing / AmazonGlobal / Localization
  • Cross Border / Rule Writing - ML — Cross Border Commerce (ML)

▸ SubTask Auto-Selection
  After punching a tag, the extension automatically selects the correct subtask:
  
  For ML tags:
  • RW_Artemis_Image_ML — for rules ending in _Artemis_Image_ML
  • RW_Artemis_TII_ML — for rules ending in _TII_Artemis_ML
  • RW_Artemis_ML — for rules ending in _Artemis_ML
  • RW_Auto_ML — for rules ending in _ML (non-Artemis)
  
  For KW tags:
  • RW_Artemis_KW — if the rule name contains "Artemis"
  • RW_KW — if no Artemis reference

▸ Marketplace Auto-Selection
  Extracts the marketplace code from the rule name and selects it in Argus:
  
  • Reads the 2-letter country code from the rule path (e.g., SG_Soil → SG)
  • Supports all Amazon marketplaces: US, CA, MX, BR, GB, DE, FR, IT, ES, NL, PL, SE, BE, TR, EG, AE, SA, IN, JP, AU, SG, ZA, IE, and more
  • Defaults to US when no valid marketplace code is detected
  • For Artemis pages, reads the marketplace from the conversation text

▸ Floating Widget on Every Page
  A sleek, draggable floating widget appears on every webpage you visit. It provides:
  
  • Current tracking status — see which tag is active at a glance
  • Real-time timers synced from Argus — Total, Productive, BSA, and Other (Break)
  • Connection status — green dot when Argus is connected
  • Auto-punch status — shows whether auto-punching is active, paused (meeting/break), or disabled
  • 9-hour progress bar — visual indicator of your daily limit
  • Quick-action buttons for meetings and breaks
  • Minimize/expand toggle — collapse to just the header when not needed
  • Drag anywhere — position the widget wherever you prefer

▸ Meeting & Break Management
  Quickly log meetings and breaks without switching to Argus:
  
  • Meeting (Task) — Opens a text input for describing the work type, then punches "Meetings- task related" with the description in the SweetAlert popup
  • Meeting (Non-Task) — Immediately punches "Meetings - non task related"
  • Break — Punches "Break" in Argus
  • Stop & Resume — Stops the current meeting/break and resumes auto-punching
  
  While a meeting or break is active, auto-punching is paused to prevent accidental tag switches.

▸ Intelligent Time Limits
  The extension enforces three time limits based on Argus timer values:
  
  1. Break Limit (1 hour)
     • Tracks "Other" time in Argus (which represents breaks)
     • When Other reaches 1 hour, break is automatically stopped
     • Work tracking resumes automatically
     • Break button is disabled for the rest of the day
     • Full-screen overlay alert appears on your current page
  
  2. Work Limit (8 hours)
     • Tracks Productive + BSA time in Argus
     • When combined work time reaches 8 hours, current activity stops
     • Break is automatically punched for you
     • Full-screen overlay informs you to take your 1-hour break
  
  3. Day Limit (9 hours)
     • Tracks Total time in Argus (Productive + BSA + Other)
     • When total reaches 9 hours, ALL tracking stops
     • All buttons are disabled
     • Full-screen overlay shows your day summary with time breakdown
  
  Limits are checked every 10 seconds and on every timer update from Argus.

▸ Full-Screen Overlay Alerts
  When important events occur, a full-screen overlay appears on your current page:
Break Limit Reached — Red overlay, "Your 1-hour break has been used up"
  • 8 Hours Work Complete — Orange overlay, "Break has been started automatically"
  • Day Complete (9 Hours) — Blue overlay with day summary, "Have a great evening!"
  • Argus Not Open — Yellow overlay, "Please open Argus to enable time tracking"
  
  Overlays must be dismissed by clicking a button — they cannot be missed.
  The Argus reminder overlay repeats every 30 minutes until Argus is opened.

▸ Multi-Window Support
  Works seamlessly across multiple browser windows:
  
  • Detects window focus changes (Alt+Tab, clicking taskbar)
  • Detects tab switches within the same window (Ctrl+Tab)
  • Detects page navigation and loading
  • Auto-punches correctly regardless of which window is active

▸ Argus Not Open Reminders
  If Argus Time Tracker is not open:
  
  • Widget shows a persistent orange warning bar on all pages
  • Full-screen overlay appears after 5 seconds
  • If dismissed, overlay returns every 30 minutes
  • Chrome notification sent on startup: "Good morning! Please open Argus"
  • Repeated notification every 5 minutes until Argus is opened
  • Once Argus is opened, all reminders stop
 HOW IT WORKS

1. Open Argus Time Tracker in a browser tab (must stay open)
2. Open CP Central tabs for your work
3. Switch between CP Central tabs as you work
4. The extension automatically:
   → Detects the program (RP, PA, CBC) from the page
   → Determines ML or KW status
   → Stops the current Argus activity
   → Opens a fresh activity form (START GENERAL ACTIVITY)
   → Clicks the correct tab (MY TASKS or BSA/OTHER)
   → Types the tag name and selects from dropdown
   → Clicks SAVE
   → Selects the correct SubTask
   → Selects the correct Marketplace
   → Clicks SAVE again

All of this happens in seconds, in the background, while you continue working.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 SUPPORTED TAGS

MY TASKS (Rule Writing — Productive):
  • RP / Rule Writing
  • RP / Rule Writing - ML
  • PA / Rule Writing - KW
  • PA / Rule Writing - ML
  • Cross Border / Rule Writing
  • Cross Border / Rule Writing - ML

BSA/OTHER:
  • Meetings- task related (with work type description)
  • Meetings - non task related
  • Break
⏱️ TIME MANAGEMENT RULES

Daily Time Budget:
  • 8 hours of work (Productive + BSA)
  • 1 hour of break (Other)
  • 9 hours total

Break Rules:
  • Maximum 1 hour of break per day
  • When break reaches 1 hour, it auto-stops
  • Work tracking resumes automatically
  • No more breaks allowed for the rest of the day
  • Break button becomes disabled and greyed out

Work Rules:
  • Maximum 8 hours of work (Productive + BSA combined)
  • When work reaches 8 hours, current activity auto-stops
  • Break is automatically punched
  • User is prompted to take their mandatory 1-hour break

Day Completion:
  • When total time reaches 9 hours, everything stops
  • All auto-punching disabled
  • All buttons disabled
  • Day summary overlay shown