NQueue Consumer

Use this skill to guide integration of dev.nishisan.utils.queue.NQueue as a library dependency in external projects.

What this skill does

• •Applies the recommended integration path (dependency + API usage).
• •Selects an options profile based on reliability/latency goals.
• •Prevents common misuses (durability and retention assumptions).
• •Provides a minimal validation checklist.

Required workflow

1. •Read ../../doc/nqueue-agent-guide.md first.
2. •If you need implementation details, read only one of:

• •../../doc/nqueue-readme.md for architecture/options behavior.
• •../../doc/nqueue-examples.md for copyable recipes.

1. •Generate integration code using NQueue.open(...), offer, poll, peek, and try-with-resources.
2. •Add a restart test for critical flows.

Decision rules for options

• •If user prioritizes durability: prefer withFsync(true).
• •If user prioritizes throughput: consider withFsync(false) and explain crash-loss risk.
• •If replay window is needed: use RetentionPolicy.TIME_BASED + withRetentionTime(...).
• •If strict persist-before-deliver is required: set withShortCircuit(false).
• •If investigating ordering anomalies: enable withOrderDetection(true) temporarily.

Output contract

When answering integration requests with this skill, include:

• •dependency snippet;
• •queue initialization snippet;
• •recommended options for the stated goal;
• •one short test checklist (including restart scenario).