feat(queue): define QueueAdapter interface types

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs/TASKS.md

@@ -7,8 +7,8 @@
 > **`agent` column values:** `codex` | `sonnet` | `haiku` | `glm-5` | `opus` | `—` (auto/default)
 
 | id        | status      | description                                                                                                              | issue | repo                 | branch                   | depends_on                    | blocks    | agent | started_at       | completed_at | estimate | used | notes                |
-| --------- | ----------- | ------------------------------------------------------------------------------------------------------------------------ | ----- | -------------------- | ------------------------ | ----------------------------- | --------- | ----- | ---------- | ------------ | -------- | ---- | ----- |
+| --------- | ----------- | ------------------------------------------------------------------------------------------------------------------------ | ----- | -------------------- | ------------------------ | ----------------------------- | --------- | ----- | ---------------- | ------------ | -------- | ---- | -------------------- |
-| SA-P1-001 | not-started | Define QueueAdapter interface in packages/queue/src/types.ts — enqueue, dequeue, length, publish, subscribe, close       |       | queue                | feat/storage-abstraction |                               | SA-P1-004 | codex |            |              | 5K       |      |       |
+| SA-P1-001 | in-progress | Define QueueAdapter interface in packages/queue/src/types.ts — enqueue, dequeue, length, publish, subscribe, close       |       | queue                | feat/storage-abstraction |                               | SA-P1-004 | codex | 2026-04-02T20:20 |              | 5K       |      | Worker: brisk-summit |
 | SA-P1-002 | not-started | Define StorageAdapter interface in packages/storage/src/types.ts — CRUD, query, find, transaction, close                 |       | storage              | feat/storage-abstraction |                               | SA-P1-004 | codex |                  |              | 8K       |      |                      |
 | SA-P1-003 | not-started | Define MemoryAdapter interface in packages/memory/src/types.ts — preferences, insights, search, embedder support         |       | memory               | feat/storage-abstraction |                               | SA-P1-004 | codex |                  |              | 5K       |      |                      |
 | SA-P1-004 | not-started | Create adapter factory pattern + config types: createQueue(config), createStorage(config), createMemory(config)          |       | queue,storage,memory | feat/storage-abstraction | SA-P1-001,SA-P1-002,SA-P1-003 | SA-P2-001 | codex |                  |              | 8K       |      |                      |

packages/queue/src/index.ts

@@ -6,3 +6,5 @@ export {
   type QueueClient,
   type TaskPayload,
 } from './queue.js';
+
+export { type QueueAdapter, type QueueConfig as QueueAdapterConfig } from './types.js';

packages/queue/src/types.ts

@@ -0,0 +1,18 @@
+export interface TaskPayload {
+  id: string;
+  type: string;
+  data: Record<string, unknown>;
+  createdAt: string;
+}
+
+export interface QueueAdapter {
+  readonly name: string;
+  enqueue(queueName: string, payload: TaskPayload): Promise<void>;
+  dequeue(queueName: string): Promise<TaskPayload | null>;
+  length(queueName: string): Promise<number>;
+  publish(channel: string, message: string): Promise<void>;
+  subscribe(channel: string, handler: (message: string) => void): () => void;
+  close(): Promise<void>;
+}
+
+export type QueueConfig = { type: 'bullmq'; url?: string } | { type: 'local'; dataDir?: string };