annotation queue is a URL not an int - int comparisons silently never match

TL;DR

In Rossum hook code, never compare annotation queue to an integer - the payload field is a full URL ending in the queue ID, so the comparison is always false and your hook silently skips everything. Parse the ID out of the URL tail or compare against the URL form.

Steps

1. In Rossum hook code, never compare annotation queue to an integer - the payload field is a full URL ending in the queue ID, so the comparison is always false and your hook silently skips everything. Parse the ID out of the URL tail or compare against the URL form. This one fails quiet, which is why it eats hours.

When to use

You are seeing this: In Rossum hook code, never compare annotation queue to an integer - the payload field is a full URL ending in the queue ID, so the comparison is always false and your hook silently skips everything. Use this skill when you run into "annotation queue is a URL not an int - int comparisons silently never match".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Source: Rossum coding best practices: hook payloads always carry annotation.queue, but as a URL like .../api/v1/queues/[id], never a bare integer. Comparing it to an integer ID silently never matches, so the hook looks like it does nothing.

Verified resolution: In Rossum hook code, never compare annotation queue to an integer - the payload field is a full URL ending in the queue ID, so the comparison is always false and your hook silently skips everything. Parse the ID out of the URL tail or compare against the URL form. This one fails quiet, which is why it eats hours.

Source URL: https://github.com/rossumai/claude-marketplace/blob/HEAD/plugins/rossum-sa/skills/coding-best-practices/SKILL.md