rzyfront/vendix-ai-queue
skills/vendix-ai-queue/SKILL.md
AI async queue system using BullMQ: generation jobs, embedding jobs, queue registration, processors, retries, and job status. Trigger: When working with AI async processing, BullMQ queues, AI job processors, or embedding/generation background jobs.
$ install --global
skillsauthnpx skillsauth add rzyfront/vendix vendix-ai-queueInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 16, 2026, 5:04 AM220.6s1 file scanned
SKILL.md
- name:
- vendix-ai-queue
- description:
- >
- AI async queue system using BullMQ:
- generation jobs, embedding jobs, queue registration,
- processors, retries, and job status. Trigger:
- When working with AI async processing,
- license:
- Apache-2.0
- author:
- rzyfront
- version:
- 2.1
- scope:
- [root]
Source of Truth
- Queue module:
apps/backend/src/ai-engine/queue/ai-queue.module.ts - Queue service:
apps/backend/src/ai-engine/queue/ai-queue.service.ts - Generation processor:
apps/backend/src/ai-engine/queue/processors/ai-generation.processor.ts - Embedding processor:
apps/backend/src/ai-engine/queue/processors/ai-embedding.processor.ts - Embedding module registration:
apps/backend/src/ai-engine/embeddings/embedding.module.ts
Queues
AIQueueModule registers queues:
ai-generationai-embeddingai-agent
Current processor reality:
AIGenerationProcessoris registered inAIQueueModule.AIEmbeddingProcessorexists but is registered inEmbeddingModule, notAIQueueModule.- No
AIAgentProcessorwas found forai-agent;enqueueAgentTask()can enqueue jobs without a processor unless one is added.
Job Methods
AIQueueService.enqueueGeneration():
- Queue
ai-generation, jobgenerate. - Attempts 3, exponential backoff 2000ms.
- Keeps completed 100, failed 50.
- Adds
request_id.
enqueueEmbedding():
- Queue
ai-embedding, jobembed. - Attempts 2, exponential backoff 3000ms.
- Keeps completed 500, failed 100.
enqueueAgentTask():
- Queue
ai-agent, jobagent-task. - Attempts 1.
- Requires a processor before relying on it operationally.
Processors
Generation processor:
- Recreates request context with
RequestContextService.run(). - Calls
aiEngine.run(app_key, variables, messages). - Emits
ai.generation.completedorai.generation.failed.
Embedding processor:
- Handles
delete-embeddingspecially. - Otherwise stores embedding through
EmbeddingService.storeEmbedding(). - Does not emit completion/failure events.
Rules
- Pass required tenant/user context in job data; request context is not naturally available in workers.
- Do not assume all registered queues have processors.
- Add processors to module providers explicitly.
- Let BullMQ retry by throwing from processors on failures.
- Use
getJobStatus(queueName, jobId)for status checks.
Related Skills
vendix-ai-platform-corevendix-ai-embeddings-ragvendix-ai-agent-tools
Related Skills
rzyfront/mobile-dev
development
VerifiedTrustedCommunity
Mobile app development rules for Vendix Expo/React Native project. Trigger: When editing, creating, or modifying any file under apps/mobile, or when developing mobile-specific features.
5SKILL.mdUpdated May 29, 2026
rzyfront/vendix-subscription-gate
development
VerifiedTrustedCommunity
Feature gating by store subscription state: global store write guard, AI feature gate, Redis feature resolution, quota consumption, frontend paywall interceptor, banner, and subscription UI states. Trigger: When adding feature gates, paywalls, subscription-based access control, protecting store write operations, AI feature gates, or rollout flags.
5SKILL.mdUpdated May 16, 2026
rzyfront/vendix-saas-billing
testing
VerifiedTrustedCommunity
SaaS subscription billing for Vendix stores: plan pricing, invoices, Wompi platform payments, manual payments, partner commissions, payouts, proration, and dunning. Trigger: When creating SaaS invoices, working with partner rev-share, margin/surcharge pricing, invoice sequence allocation, partner payout batches, subscription payments, manual payments, or dunning flows.
5SKILL.mdUpdated May 16, 2026
rzyfront/vendix-redis-quota
development
VerifiedTrustedCommunity
Periodic quota counters with Redis, UTC period keys, Lua-based idempotent AI quota consumption, request-id deduplication, and post-success consumption. Trigger: When building quota counters, enforcing monthly/daily feature caps, or reusing AI quota patterns for uploads, emails, exports, or rate-limited features.
5SKILL.mdUpdated May 16, 2026