name	namespace-qualified-queue-keys
description	Protect namespace-local identifiers when a shared queue schema only has one key column
domain	stateful storage, queueing, namespaces
confidence	medium
source	earned

Context

Use this when callers see identifiers as namespace-local (session_id, slug, etc.) but the backing queue or job table stores only a single key column. Without an internal qualification step, identical ids from different namespaces collapse onto the same pending row and silently corrupt queue semantics.

Patterns

Keep the public id stable. Do not widen the external MCP/CLI contract if the caller should still think in namespace-local ids.
Qualify only at the storage boundary. Build an internal queue key like <namespace>::<id> right before enqueue/dequeue bookkeeping.
Preserve the natural path alongside the key. Store the file/path payload unchanged so workers can still open the right artifact without reverse-engineering the internal key.
Test both file isolation and queue isolation. It is not enough to prove two namespaces write different files; assert they also produce distinct pending jobs.

Anti-patterns

Reusing raw namespace-local ids in a shared queue table
Widening the public API just to patch an internal queue collision
Assuming file-path isolation automatically prevents queue collapse

Más de este repositorio

mismo repositorio

quaid-research

quaid-app/quaid

Resolve knowledge gaps: fetch unresolved gaps, assess sensitivity, generate research queries, ingest findings, and close gaps with a resolution slug.

2026-06-132

quaid-alerts

quaid-app/quaid

Interrupt-driven alerts: detect and surface new contradictions, stale pages, resolved gaps, and embedding drift. Priority-classified with deduplication.

2026-06-132

quaid-ingest

quaid-app/quaid

Ingest meeting notes, articles, documents, and conversations into Quaid. Handles idempotent ingestion for exact-byte duplicates and vault-backed sync.

2026-06-132

quaid-maintain

quaid-app/quaid

Keep the brain healthy: detect and resolve contradictions via the correction / supersede workflow, validate referential integrity, triage knowledge gaps, find orphaned pages, and compact the database.

2026-06-132

quaid-query

quaid-app/quaid

Answer questions from the brain using FTS5 + semantic search + structured queries. Synthesize across multiple pages. Cite sources.

2026-06-132

quaid-upgrade

quaid-app/quaid

Agent-guided binary upgrades: version check, channel detection, download via install.sh (or manual asset fetch + SHA-256 verify), and post-upgrade validation.

2026-06-132

name	namespace-qualified-queue-keys
description	Protect namespace-local identifiers when a shared queue schema only has one key column
domain	stateful storage, queueing, namespaces
confidence	medium
source	earned

Context

Patterns

Keep the public id stable. Do not widen the external MCP/CLI contract if the caller should still think in namespace-local ids.
Qualify only at the storage boundary. Build an internal queue key like <namespace>::<id> right before enqueue/dequeue bookkeeping.
Preserve the natural path alongside the key. Store the file/path payload unchanged so workers can still open the right artifact without reverse-engineering the internal key.
Test both file isolation and queue isolation. It is not enough to prove two namespaces write different files; assert they also produce distinct pending jobs.

Anti-patterns

Reusing raw namespace-local ids in a shared queue table
Widening the public API just to patch an internal queue collision
Assuming file-path isolation automatically prevents queue collapse