worker-dojo-jobs Package Skill

Package: @epicdm/worker-dojo-jobs Repository: flowstate-platform Path: packages/worker-dojo-jobs Version: 0.1.0

Use this published Dojo skill as the package-level entrypoint. For detailed workflows, use the package-local skills listed below.

Primary Package Workflow

Dojo Jobs Worker

Status: Active Purpose: Preserve queue dispatch and retry behavior for deferred Dojo operations. Scope: packages/worker-dojo-jobs/src/index.ts and src/env.ts Trigger: New job type, failed queue processing, binding change, retry/DLQ behavior, or deployment config work. Input: Queue payload type, Cloudflare message attempts, and required bindings. Output: Correct dispatch, ack/retry/DLQ behavior, and tests.

Workflow

1. Add or update the payload type in the relevant handler module.
2. Dispatch by payload.type in src/index.ts.
3. Ack only after a handler returns successfully.
4. On failure before the third attempt, call message.retry().
5. On message.attempts >= 3, send a DLQ envelope to EVENTS_QUEUE and ack the original message.
6. Ack unknown job types after logging so malformed messages do not retry forever.
7. Update src/env.ts and Wrangler config when bindings change.

Verification

• Add queue-level tests when dispatch behavior changes.
• Run yarn workspace @epicdm/worker-dojo-jobs test.
• Run yarn workspace @epicdm/worker-dojo-jobs typecheck.

Package Skill Inventory

Skill Inventory: @epicdm/worker-dojo-jobs

Package Role

@epicdm/worker-dojo-jobs consumes deferred Dojo compilation jobs, writes compiled artifacts to R2, updates catalog search embeddings, advances version statuses, and emits lifecycle events.

Skills

Composition Notes

• Compose with dojo-publish-catalog in worker-dojo-api; publish routes enqueue the jobs handled here.
• Coordinate compile artifact path changes with install/download routes.
• Keep Workers AI/Vectorize failures non-fatal unless product requirements explicitly change.

Review Gate

Review Gate: @epicdm/worker-dojo-jobs Skills

Result

Pass.

Checks

• Skills are backed by queue worker, bindings, handlers, and compile tests.
• Queue retry/DLQ and non-fatal Vectorize behavior are explicit.
• Verification commands are package-local.

Start with this skill to understand the package purpose, then use the package-local focused skills for specific workflows. Keep this Dojo version aligned with packages/worker-dojo-jobs/package.json. Do not treat generated feature lists as lessons; use workflow evidence from CODE-REVIEW.md, SKILL-INVENTORY.md, and REVIEW.md.