@quantod/qq 0.1.0

package/bin/qq

@@ -0,0 +1,2 @@
+#!/bin/sh
+exec node "$(dirname "$0")/../dist/index.js" "$@"

package/dist/commands.d.ts

@@ -0,0 +1,43 @@
+export declare class QQError extends Error {
+    constructor(message: string);
+}
+export interface Message {
+    id: string;
+    subqueue: string;
+    claimed: boolean;
+    claimed_by: string | null;
+    seq: number;
+    created: number;
+    last_modified: number;
+    payload?: string | null;
+}
+export interface FilterOptions {
+    claimed?: boolean;
+    claimed_by?: string;
+    ids?: string[];
+    created_after?: number;
+    created_before?: number;
+    modified_after?: number;
+    limit?: number;
+    offset?: number;
+}
+export interface ReleaseOptions {
+    target?: string;
+    payload?: string;
+    replace?: boolean;
+}
+export declare function makeQueue(nameSuffix?: string): string;
+export declare function deleteQueue(queue: string): void;
+export declare function push(path: string, id: string, payload?: string): void;
+export declare function claim(path: string, options?: {
+    agentId?: string;
+}): Message | null;
+export declare function release(queue: string, id: string, options?: ReleaseOptions): void;
+export declare function list(path: string, filters?: FilterOptions): Message[];
+export declare function batchRead(path: string, filters?: FilterOptions): Message[];
+export declare function stats(queue: string): Record<string, {
+    total: number;
+    claimed: number;
+}>;
+export declare function reap(queue: string, agentId?: string): number;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAQA,qBAAa,OAAQ,SAAQ,KAAK;gBACpB,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAmCD,wBAAgB,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CASrD;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE/C;AAID,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAkBrE;AAID,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,GAAG,IAAI,CAwBtF;AAID,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,IAAI,CA4BrF;AA8DD,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,EAAE,CAEzE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,EAAE,CAE9E;AAID,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBvF;AAID,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAiB5D"}

package/dist/commands.js

@@ -0,0 +1,236 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QQError = void 0;
+exports.makeQueue = makeQueue;
+exports.deleteQueue = deleteQueue;
+exports.push = push;
+exports.claim = claim;
+exports.release = release;
+exports.list = list;
+exports.batchRead = batchRead;
+exports.stats = stats;
+exports.reap = reap;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_crypto_1 = require("node:crypto");
+const db_js_1 = require("./db.js");
+// ── types ──────────────────────────────────────────────────────────────────────
+class QQError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'QQError';
+    }
+}
+exports.QQError = QQError;
+// ── internal helpers ───────────────────────────────────────────────────────────
+function parsePath(path) {
+    const slash = path.indexOf('/');
+    if (slash === -1)
+        return { queue: path, subqueue: undefined };
+    return { queue: path.slice(0, slash), subqueue: path.slice(slash + 1) };
+}
+function toGlob(pattern) {
+    return pattern.replace(/\*/g, '%').replace(/\?/g, '_');
+}
+function nextSeq(db) {
+    const row = db.prepare('SELECT MAX(seq) as m FROM messages').get();
+    return (row.m ?? 0) + 1;
+}
+function rowToMessage(row, includePayload) {
+    const msg = {
+        id: row.id,
+        subqueue: row.subqueue,
+        claimed: Boolean(row.claimed),
+        claimed_by: row.claimed_by ?? null,
+        seq: row.seq,
+        created: row.created,
+        last_modified: row.last_modified,
+    };
+    if (includePayload)
+        msg.payload = row.payload ?? null;
+    return msg;
+}
+// ── makeQueue ─────────────────────────────────────────────────────────────────
+function makeQueue(nameSuffix) {
+    const now = new Date();
+    const mm = String(now.getMonth() + 1).padStart(2, '0');
+    const dd = String(now.getDate()).padStart(2, '0');
+    const suffix = nameSuffix ?? (0, node_crypto_1.randomBytes)(3).toString('hex');
+    const name = `${mm}${dd}_${suffix}`;
+    const db = (0, db_js_1.openDb)(name);
+    db.close();
+    return name;
+}
+// ── deleteQueue ───────────────────────────────────────────────────────────────
+function deleteQueue(queue) {
+    (0, node_fs_1.rmSync)((0, node_path_1.join)(process.cwd(), '.claude', 'qq', `${queue}.db`), { force: true });
+}
+// ── push ──────────────────────────────────────────────────────────────────────
+function push(path, id, payload) {
+    const { queue, subqueue } = parsePath(path);
+    if (!subqueue)
+        throw new QQError('path must include a subqueue: queue/subqueue');
+    const db = (0, db_js_1.openDb)(queue);
+    try {
+        (0, db_js_1.inTransaction)(db, () => {
+            const existing = db.prepare('SELECT id FROM messages WHERE id = ?').get(id);
+            if (existing)
+                throw new QQError(`duplicate id: ${id}`);
+            const seq = nextSeq(db);
+            const now = Date.now();
+            db.prepare('INSERT INTO messages (id, subqueue, claimed, seq, payload, created, last_modified) VALUES (?, ?, 0, ?, ?, ?, ?)').run(id, subqueue, seq, payload ?? null, now, now);
+        });
+    }
+    finally {
+        db.close();
+    }
+}
+// ── claim ─────────────────────────────────────────────────────────────────────
+function claim(path, options = {}) {
+    const { queue, subqueue } = parsePath(path);
+    if (!subqueue)
+        throw new QQError('path must include a subqueue: queue/subqueue');
+    const db = (0, db_js_1.openDb)(queue);
+    try {
+        return (0, db_js_1.inTransaction)(db, () => {
+            const pattern = toGlob(subqueue);
+            const row = db.prepare('SELECT * FROM messages WHERE subqueue LIKE ? AND claimed = 0 ORDER BY seq ASC LIMIT 1').get(pattern);
+            if (!row)
+                return null;
+            const now = Date.now();
+            db.prepare('UPDATE messages SET claimed = 1, claimed_by = ?, last_modified = ? WHERE id = ?').run(options.agentId ?? null, now, row.id);
+            return rowToMessage({ ...row, claimed: 1, claimed_by: options.agentId ?? null }, true);
+        });
+    }
+    finally {
+        db.close();
+    }
+}
+// ── release ───────────────────────────────────────────────────────────────────
+function release(queue, id, options = {}) {
+    const db = (0, db_js_1.openDb)(queue);
+    try {
+        (0, db_js_1.inTransaction)(db, () => {
+            const row = db.prepare('SELECT * FROM messages WHERE id = ?').get(id);
+            if (!row)
+                throw new QQError(`message not found: ${id}`);
+            if (!row.claimed)
+                throw new QQError(`message not claimed: ${id}`);
+            const seq = nextSeq(db);
+            const now = Date.now();
+            const newSubqueue = options.target ?? row.subqueue;
+            let newPayload;
+            if (options.payload !== undefined) {
+                newPayload = options.replace
+                    ? options.payload
+                    : [row.payload, options.payload].filter(Boolean).join('\n');
+            }
+            else {
+                newPayload = row.payload ?? null;
+            }
+            db.prepare('UPDATE messages SET claimed = 0, claimed_by = NULL, seq = ?, subqueue = ?, payload = ?, last_modified = ? WHERE id = ?').run(seq, newSubqueue, newPayload, now, id);
+        });
+    }
+    finally {
+        db.close();
+    }
+}
+// ── list / batchRead ──────────────────────────────────────────────────────────
+function queryMessages(path, filters, includePayload) {
+    const { queue, subqueue } = parsePath(path);
+    const db = (0, db_js_1.openDb)(queue);
+    try {
+        const conditions = [];
+        const params = [];
+        if (subqueue) {
+            conditions.push('subqueue LIKE ?');
+            params.push(toGlob(subqueue));
+        }
+        if (filters.claimed !== undefined) {
+            conditions.push('claimed = ?');
+            params.push(filters.claimed ? 1 : 0);
+        }
+        if (filters.claimed_by !== undefined) {
+            conditions.push('claimed_by = ?');
+            params.push(filters.claimed_by);
+        }
+        if (filters.ids?.length) {
+            conditions.push(`id IN (${filters.ids.map(() => '?').join(', ')})`);
+            params.push(...filters.ids);
+        }
+        if (filters.created_after !== undefined) {
+            conditions.push('created > ?');
+            params.push(filters.created_after);
+        }
+        if (filters.created_before !== undefined) {
+            conditions.push('created < ?');
+            params.push(filters.created_before);
+        }
+        if (filters.modified_after !== undefined) {
+            conditions.push('last_modified > ?');
+            params.push(filters.modified_after);
+        }
+        let sql = 'SELECT * FROM messages';
+        if (conditions.length)
+            sql += ' WHERE ' + conditions.join(' AND ');
+        sql += ' ORDER BY seq ASC';
+        if (filters.limit !== undefined) {
+            sql += ' LIMIT ?';
+            params.push(filters.limit);
+        }
+        else if (filters.offset !== undefined) {
+            sql += ' LIMIT -1';
+        }
+        if (filters.offset !== undefined) {
+            sql += ' OFFSET ?';
+            params.push(filters.offset);
+        }
+        const rows = db.prepare(sql).all(...params);
+        return rows.map(r => rowToMessage(r, includePayload));
+    }
+    finally {
+        db.close();
+    }
+}
+function list(path, filters = {}) {
+    return queryMessages(path, filters, false);
+}
+function batchRead(path, filters = {}) {
+    return queryMessages(path, filters, true);
+}
+// ── stats ─────────────────────────────────────────────────────────────────────
+function stats(queue) {
+    const db = (0, db_js_1.openDb)(queue);
+    try {
+        const rows = db.prepare('SELECT subqueue, claimed, COUNT(*) as count FROM messages GROUP BY subqueue, claimed').all();
+        const result = {};
+        for (const row of rows) {
+            if (!result[row.subqueue])
+                result[row.subqueue] = { total: 0, claimed: 0 };
+            result[row.subqueue].total += row.count;
+            if (row.claimed)
+                result[row.subqueue].claimed += row.count;
+        }
+        return result;
+    }
+    finally {
+        db.close();
+    }
+}
+// ── reap ──────────────────────────────────────────────────────────────────────
+function reap(queue, agentId) {
+    const db = (0, db_js_1.openDb)(queue);
+    try {
+        return (0, db_js_1.inTransaction)(db, () => {
+            const now = Date.now();
+            const result = agentId
+                ? db.prepare('UPDATE messages SET claimed = 0, claimed_by = NULL, last_modified = ? WHERE claimed = 1 AND claimed_by = ?').run(now, agentId)
+                : db.prepare('UPDATE messages SET claimed = 0, claimed_by = NULL, last_modified = ? WHERE claimed = 1').run(now);
+            return result.changes;
+        });
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"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"}

package/dist/db.d.ts

@@ -0,0 +1,4 @@
+import Database from 'better-sqlite3';
+export declare function openDb(queueName: string): Database.Database;
+export declare function inTransaction<T>(db: Database.Database, fn: () => T): T;
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAkBtC,wBAAgB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAQ3D;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEtE"}

package/dist/db.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openDb = openDb;
+exports.inTransaction = inTransaction;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const DDL = `
+CREATE TABLE IF NOT EXISTS messages (
+  id            TEXT PRIMARY KEY,
+  subqueue      TEXT NOT NULL,
+  claimed       INTEGER NOT NULL DEFAULT 0,
+  seq           INTEGER NOT NULL,
+  payload       TEXT,
+  claimed_by    TEXT,
+  created       INTEGER NOT NULL,
+  last_modified INTEGER NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_claim ON messages (subqueue, claimed, seq);
+`;
+function openDb(queueName) {
+    const dir = (0, node_path_1.join)(process.cwd(), '.claude', 'qq');
+    (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    const db = new better_sqlite3_1.default((0, node_path_1.join)(dir, `${queueName}.db`));
+    db.pragma('journal_mode = WAL');
+    db.pragma('busy_timeout = 5000');
+    db.exec(DDL);
+    return db;
+}
+function inTransaction(db, fn) {
+    return db.transaction(fn).immediate();
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":";;;;;AAkBA,wBAQC;AAED,sCAEC;AA9BD,oEAAsC;AACtC,qCAAoC;AACpC,yCAAiC;AAEjC,MAAM,GAAG,GAAG;;;;;;;;;;;;CAYX,CAAC;AAEF,SAAgB,MAAM,CAAC,SAAiB;IACtC,MAAM,GAAG,GAAG,IAAA,gBAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACjD,IAAA,mBAAS,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,IAAI,wBAAQ,CAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC;IACtD,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACjC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAgB,aAAa,CAAI,EAAqB,EAAE,EAAW;IACjE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const node_fs_1 = require("node:fs");
+const js_yaml_1 = require("js-yaml");
+const commands_js_1 = require("./commands.js");
+function out(data) {
+    process.stdout.write((0, js_yaml_1.dump)(data, { lineWidth: -1 }));
+}
+function fail(message) {
+    process.stderr.write(`error: ${message}\n`);
+    process.exit(1);
+}
+function readStdin() {
+    if (process.stdin.isTTY)
+        return null;
+    const raw = (0, node_fs_1.readFileSync)(0, 'utf8').trim();
+    return raw || null;
+}
+function parseIntArg(value) {
+    const n = parseInt(value, 10);
+    if (isNaN(n))
+        throw new commander_1.InvalidArgumentError('expected an integer');
+    return n;
+}
+function collectFilters(opts) {
+    const f = {};
+    if (opts['claimed'] !== undefined)
+        f.claimed = opts['claimed'] === '1';
+    if (opts['claimedBy'])
+        f.claimed_by = opts['claimedBy'];
+    if (opts['ids'])
+        f.ids = opts['ids'].split(',');
+    if (opts['createdAfter'])
+        f.created_after = opts['createdAfter'];
+    if (opts['createdBefore'])
+        f.created_before = opts['createdBefore'];
+    if (opts['modifiedAfter'])
+        f.modified_after = opts['modifiedAfter'];
+    if (opts['limit'] !== undefined)
+        f.limit = opts['limit'];
+    if (opts['offset'] !== undefined)
+        f.offset = opts['offset'];
+    return f;
+}
+function addFilterOptions(cmd) {
+    return cmd
+        .option('--claimed <0|1>')
+        .option('--claimed-by <agent>')
+        .option('--ids <id1,id2,...>')
+        .option('--created-after <epoch>', '', parseIntArg)
+        .option('--created-before <epoch>', '', parseIntArg)
+        .option('--modified-after <epoch>', '', parseIntArg)
+        .option('--limit <n>', '', parseIntArg)
+        .option('--offset <n>', '', parseIntArg);
+}
+const program = new commander_1.Command();
+program.name('qq').description('Persistent queue for Claude agent pipelines');
+program
+    .command('make-queue')
+    .option('--name <suffix>')
+    .action((opts) => {
+    try {
+        out({ queue: (0, commands_js_1.makeQueue)(opts.name) });
+    }
+    catch (e) {
+        fail(e instanceof Error ? e.message : String(e));
+    }
+});
+program
+    .command('delete-queue <queue>')
+    .action((queue) => {
+    try {
+        (0, commands_js_1.deleteQueue)(queue);
+    }
+    catch (e) {
+        fail(e instanceof Error ? e.message : String(e));
+    }
+});
+program
+    .command('push <path> <id>')
+    .action((path, id) => {
+    try {
+        (0, commands_js_1.push)(path, id, readStdin() ?? undefined);
+        out({ ok: true });
+    }
+    catch (e) {
+        e instanceof commands_js_1.QQError ? fail(e.message) : fail(String(e));
+    }
+});
+program
+    .command('claim <path>')
+    .option('--agent-id <id>')
+    .action((path, opts) => {
+    try {
+        out((0, commands_js_1.claim)(path, { agentId: opts.agentId }) ?? { empty: true });
+    }
+    catch (e) {
+        fail(e instanceof Error ? e.message : String(e));
+    }
+});
+program
+    .command('release <queue> <id>')
+    .option('--target <subqueue>')
+    .option('--payload', 'read payload from stdin')
+    .option('--replace')
+    .action((queue, id, opts) => {
+    try {
+        const releaseOpts = { target: opts.target, replace: opts.replace };
+        if (opts.payload)
+            releaseOpts.payload = readStdin() ?? undefined;
+        (0, commands_js_1.release)(queue, id, releaseOpts);
+        out({ ok: true });
+    }
+    catch (e) {
+        e instanceof commands_js_1.QQError ? fail(e.message) : fail(String(e));
+    }
+});
+addFilterOptions(program.command('list <path>'))
+    .action((path, opts) => {
+    try {
+        out((0, commands_js_1.list)(path, collectFilters(opts)));
+    }
+    catch (e) {
+        fail(e instanceof Error ? e.message : String(e));
+    }
+});
+addFilterOptions(program.command('batch-read <path>'))
+    .action((path, opts) => {
+    try {
+        out((0, commands_js_1.batchRead)(path, collectFilters(opts)));
+    }
+    catch (e) {
+        fail(e instanceof Error ? e.message : String(e));
+    }
+});
+program
+    .command('stats <queue>')
+    .action((queue) => {
+    try {
+        out((0, commands_js_1.stats)(queue));
+    }
+    catch (e) {
+        fail(e instanceof Error ? e.message : String(e));
+    }
+});
+program
+    .command('reap <queue> [agent-id]')
+    .action((queue, agentId) => {
+    try {
+        out({ reaped: (0, commands_js_1.reap)(queue, agentId) });
+    }
+    catch (e) {
+        fail(e instanceof Error ? e.message : String(e));
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@quantod/qq",
+  "version": "0.1.0",
+  "description": "Persistent queue for multi-stage Claude agent pipelines",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "main": "./dist/commands.js",
+  "exports": {
+    ".": "./dist/commands.js"
+  },
+  "bin": {
+    "qq": "./bin/qq"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "better-sqlite3": "^12.0.0",
+    "commander": "^13.1.0",
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.0"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "test": "vitest run",
+    "lint": "tsc --noEmit"
+  }
+}

package/src/commands.ts

@@ -0,0 +1,284 @@
+import { rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { randomBytes } from 'node:crypto';
+import type Database from 'better-sqlite3';
+import { openDb, inTransaction } from './db.js';
+
+// ── types ──────────────────────────────────────────────────────────────────────
+
+export class QQError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'QQError';
+  }
+}
+
+export interface Message {
+  id: string;
+  subqueue: string;
+  claimed: boolean;
+  claimed_by: string | null;
+  seq: number;
+  created: number;
+  last_modified: number;
+  payload?: string | null;
+}
+
+export interface FilterOptions {
+  claimed?: boolean;
+  claimed_by?: string;
+  ids?: string[];
+  created_after?: number;
+  created_before?: number;
+  modified_after?: number;
+  limit?: number;
+  offset?: number;
+}
+
+export interface ReleaseOptions {
+  target?: string;
+  payload?: string;
+  replace?: boolean;
+}
+
+// ── internal helpers ───────────────────────────────────────────────────────────
+
+function parsePath(path: string): { queue: string; subqueue: string | undefined } {
+  const slash = path.indexOf('/');
+  if (slash === -1) return { queue: path, subqueue: undefined };
+  return { queue: path.slice(0, slash), subqueue: path.slice(slash + 1) };
+}
+
+function toGlob(pattern: string): string {
+  return pattern.replace(/\*/g, '%').replace(/\?/g, '_');
+}
+
+function nextSeq(db: Database.Database): number {
+  const row = db.prepare('SELECT MAX(seq) as m FROM messages').get() as { m: number | null };
+  return (row.m ?? 0) + 1;
+}
+
+function rowToMessage(row: Record<string, unknown>, includePayload: boolean): Message {
+  const msg: Message = {
+    id: row.id as string,
+    subqueue: row.subqueue as string,
+    claimed: Boolean(row.claimed),
+    claimed_by: (row.claimed_by as string | null) ?? null,
+    seq: row.seq as number,
+    created: row.created as number,
+    last_modified: row.last_modified as number,
+  };
+  if (includePayload) msg.payload = (row.payload as string | null) ?? null;
+  return msg;
+}
+
+// ── makeQueue ─────────────────────────────────────────────────────────────────
+
+export function makeQueue(nameSuffix?: string): string {
+  const now = new Date();
+  const mm = String(now.getMonth() + 1).padStart(2, '0');
+  const dd = String(now.getDate()).padStart(2, '0');
+  const suffix = nameSuffix ?? randomBytes(3).toString('hex');
+  const name = `${mm}${dd}_${suffix}`;
+  const db = openDb(name);
+  db.close();
+  return name;
+}
+
+// ── deleteQueue ───────────────────────────────────────────────────────────────
+
+export function deleteQueue(queue: string): void {
+  rmSync(join(process.cwd(), '.claude', 'qq', `${queue}.db`), { force: true });
+}
+
+// ── push ──────────────────────────────────────────────────────────────────────
+
+export function push(path: string, id: string, payload?: string): void {
+  const { queue, subqueue } = parsePath(path);
+  if (!subqueue) throw new QQError('path must include a subqueue: queue/subqueue');
+
+  const db = openDb(queue);
+  try {
+    inTransaction(db, () => {
+      const existing = db.prepare('SELECT id FROM messages WHERE id = ?').get(id);
+      if (existing) throw new QQError(`duplicate id: ${id}`);
+      const seq = nextSeq(db);
+      const now = Date.now();
+      db.prepare(
+        'INSERT INTO messages (id, subqueue, claimed, seq, payload, created, last_modified) VALUES (?, ?, 0, ?, ?, ?, ?)'
+      ).run(id, subqueue, seq, payload ?? null, now, now);
+    });
+  } finally {
+    db.close();
+  }
+}
+
+// ── claim ─────────────────────────────────────────────────────────────────────
+
+export function claim(path: string, options: { agentId?: string } = {}): Message | null {
+  const { queue, subqueue } = parsePath(path);
+  if (!subqueue) throw new QQError('path must include a subqueue: queue/subqueue');
+
+  const db = openDb(queue);
+  try {
+    return inTransaction(db, () => {
+      const pattern = toGlob(subqueue);
+      const row = db.prepare(
+        'SELECT * FROM messages WHERE subqueue LIKE ? AND claimed = 0 ORDER BY seq ASC LIMIT 1'
+      ).get(pattern) as Record<string, unknown> | undefined;
+
+      if (!row) return null;
+
+      const now = Date.now();
+      db.prepare(
+        'UPDATE messages SET claimed = 1, claimed_by = ?, last_modified = ? WHERE id = ?'
+      ).run(options.agentId ?? null, now, row.id as string);
+
+      return rowToMessage({ ...row, claimed: 1, claimed_by: options.agentId ?? null }, true);
+    });
+  } finally {
+    db.close();
+  }
+}
+
+// ── release ───────────────────────────────────────────────────────────────────
+
+export function release(queue: string, id: string, options: ReleaseOptions = {}): void {
+  const db = openDb(queue);
+  try {
+    inTransaction(db, () => {
+      const row = db.prepare('SELECT * FROM messages WHERE id = ?').get(id) as Record<string, unknown> | undefined;
+      if (!row) throw new QQError(`message not found: ${id}`);
+      if (!row.claimed) throw new QQError(`message not claimed: ${id}`);
+
+      const seq = nextSeq(db);
+      const now = Date.now();
+      const newSubqueue = options.target ?? (row.subqueue as string);
+
+      let newPayload: string | null;
+      if (options.payload !== undefined) {
+        newPayload = options.replace
+          ? options.payload
+          : [row.payload as string | null, options.payload].filter(Boolean).join('\n');
+      } else {
+        newPayload = (row.payload as string | null) ?? null;
+      }
+
+      db.prepare(
+        'UPDATE messages SET claimed = 0, claimed_by = NULL, seq = ?, subqueue = ?, payload = ?, last_modified = ? WHERE id = ?'
+      ).run(seq, newSubqueue, newPayload, now, id);
+    });
+  } finally {
+    db.close();
+  }
+}
+
+// ── list / batchRead ──────────────────────────────────────────────────────────
+
+function queryMessages(path: string, filters: FilterOptions, includePayload: boolean): Message[] {
+  const { queue, subqueue } = parsePath(path);
+  const db = openDb(queue);
+  try {
+    const conditions: string[] = [];
+    const params: (string | number | null)[] = [];
+
+    if (subqueue) {
+      conditions.push('subqueue LIKE ?');
+      params.push(toGlob(subqueue));
+    }
+    if (filters.claimed !== undefined) {
+      conditions.push('claimed = ?');
+      params.push(filters.claimed ? 1 : 0);
+    }
+    if (filters.claimed_by !== undefined) {
+      conditions.push('claimed_by = ?');
+      params.push(filters.claimed_by);
+    }
+    if (filters.ids?.length) {
+      conditions.push(`id IN (${filters.ids.map(() => '?').join(', ')})`);
+      params.push(...filters.ids);
+    }
+    if (filters.created_after !== undefined) {
+      conditions.push('created > ?');
+      params.push(filters.created_after);
+    }
+    if (filters.created_before !== undefined) {
+      conditions.push('created < ?');
+      params.push(filters.created_before);
+    }
+    if (filters.modified_after !== undefined) {
+      conditions.push('last_modified > ?');
+      params.push(filters.modified_after);
+    }
+
+    let sql = 'SELECT * FROM messages';
+    if (conditions.length) sql += ' WHERE ' + conditions.join(' AND ');
+    sql += ' ORDER BY seq ASC';
+
+    if (filters.limit !== undefined) {
+      sql += ' LIMIT ?';
+      params.push(filters.limit);
+    } else if (filters.offset !== undefined) {
+      sql += ' LIMIT -1';
+    }
+    if (filters.offset !== undefined) {
+      sql += ' OFFSET ?';
+      params.push(filters.offset);
+    }
+
+    const rows = db.prepare(sql).all(...params) as Record<string, unknown>[];
+    return rows.map(r => rowToMessage(r, includePayload));
+  } finally {
+    db.close();
+  }
+}
+
+export function list(path: string, filters: FilterOptions = {}): Message[] {
+  return queryMessages(path, filters, false);
+}
+
+export function batchRead(path: string, filters: FilterOptions = {}): Message[] {
+  return queryMessages(path, filters, true);
+}
+
+// ── stats ─────────────────────────────────────────────────────────────────────
+
+export function stats(queue: string): Record<string, { total: number; claimed: number }> {
+  const db = openDb(queue);
+  try {
+    const rows = db.prepare(
+      'SELECT subqueue, claimed, COUNT(*) as count FROM messages GROUP BY subqueue, claimed'
+    ).all() as { subqueue: string; claimed: number; count: number }[];
+
+    const result: Record<string, { total: number; claimed: number }> = {};
+    for (const row of rows) {
+      if (!result[row.subqueue]) result[row.subqueue] = { total: 0, claimed: 0 };
+      result[row.subqueue].total += row.count;
+      if (row.claimed) result[row.subqueue].claimed += row.count;
+    }
+    return result;
+  } finally {
+    db.close();
+  }
+}
+
+// ── reap ──────────────────────────────────────────────────────────────────────
+
+export function reap(queue: string, agentId?: string): number {
+  const db = openDb(queue);
+  try {
+    return inTransaction(db, () => {
+      const now = Date.now();
+      const result = agentId
+        ? db.prepare(
+            'UPDATE messages SET claimed = 0, claimed_by = NULL, last_modified = ? WHERE claimed = 1 AND claimed_by = ?'
+          ).run(now, agentId)
+        : db.prepare(
+            'UPDATE messages SET claimed = 0, claimed_by = NULL, last_modified = ? WHERE claimed = 1'
+          ).run(now);
+      return result.changes;
+    });
+  } finally {
+    db.close();
+  }
+}

package/src/db.ts

@@ -0,0 +1,31 @@
+import Database from 'better-sqlite3';
+import { mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+
+const DDL = `
+CREATE TABLE IF NOT EXISTS messages (
+  id            TEXT PRIMARY KEY,
+  subqueue      TEXT NOT NULL,
+  claimed       INTEGER NOT NULL DEFAULT 0,
+  seq           INTEGER NOT NULL,
+  payload       TEXT,
+  claimed_by    TEXT,
+  created       INTEGER NOT NULL,
+  last_modified INTEGER NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_claim ON messages (subqueue, claimed, seq);
+`;
+
+export function openDb(queueName: string): Database.Database {
+  const dir = join(process.cwd(), '.claude', 'qq');
+  mkdirSync(dir, { recursive: true });
+  const db = new Database(join(dir, `${queueName}.db`));
+  db.pragma('journal_mode = WAL');
+  db.pragma('busy_timeout = 5000');
+  db.exec(DDL);
+  return db;
+}
+
+export function inTransaction<T>(db: Database.Database, fn: () => T): T {
+  return db.transaction(fn).immediate();
+}

package/src/index.ts

@@ -0,0 +1,129 @@
+import { Command, InvalidArgumentError } from 'commander';
+import { readFileSync } from 'node:fs';
+import { dump } from 'js-yaml';
+import {
+  makeQueue, deleteQueue, push, claim, release,
+  list, batchRead, stats, reap, QQError,
+  type FilterOptions, type ReleaseOptions,
+} from './commands.js';
+
+function out(data: unknown): void {
+  process.stdout.write(dump(data, { lineWidth: -1 }));
+}
+
+function fail(message: string): never {
+  process.stderr.write(`error: ${message}\n`);
+  process.exit(1);
+}
+
+function readStdin(): string | null {
+  if (process.stdin.isTTY) return null;
+  const raw = readFileSync(0, 'utf8').trim();
+  return raw || null;
+}
+
+function parseIntArg(value: string): number {
+  const n = parseInt(value, 10);
+  if (isNaN(n)) throw new InvalidArgumentError('expected an integer');
+  return n;
+}
+
+function collectFilters(opts: Record<string, unknown>): FilterOptions {
+  const f: FilterOptions = {};
+  if (opts['claimed'] !== undefined) f.claimed = opts['claimed'] === '1';
+  if (opts['claimedBy']) f.claimed_by = opts['claimedBy'] as string;
+  if (opts['ids']) f.ids = (opts['ids'] as string).split(',');
+  if (opts['createdAfter']) f.created_after = opts['createdAfter'] as number;
+  if (opts['createdBefore']) f.created_before = opts['createdBefore'] as number;
+  if (opts['modifiedAfter']) f.modified_after = opts['modifiedAfter'] as number;
+  if (opts['limit'] !== undefined) f.limit = opts['limit'] as number;
+  if (opts['offset'] !== undefined) f.offset = opts['offset'] as number;
+  return f;
+}
+
+function addFilterOptions(cmd: Command): Command {
+  return cmd
+    .option('--claimed <0|1>')
+    .option('--claimed-by <agent>')
+    .option('--ids <id1,id2,...>')
+    .option('--created-after <epoch>', '', parseIntArg)
+    .option('--created-before <epoch>', '', parseIntArg)
+    .option('--modified-after <epoch>', '', parseIntArg)
+    .option('--limit <n>', '', parseIntArg)
+    .option('--offset <n>', '', parseIntArg);
+}
+
+const program = new Command();
+program.name('qq').description('Persistent queue for Claude agent pipelines');
+
+program
+  .command('make-queue')
+  .option('--name <suffix>')
+  .action((opts) => {
+    try { out({ queue: makeQueue(opts.name) }); }
+    catch (e) { fail(e instanceof Error ? e.message : String(e)); }
+  });
+
+program
+  .command('delete-queue <queue>')
+  .action((queue) => {
+    try { deleteQueue(queue); }
+    catch (e) { fail(e instanceof Error ? e.message : String(e)); }
+  });
+
+program
+  .command('push <path> <id>')
+  .action((path, id) => {
+    try { push(path, id, readStdin() ?? undefined); out({ ok: true }); }
+    catch (e) { e instanceof QQError ? fail(e.message) : fail(String(e)); }
+  });
+
+program
+  .command('claim <path>')
+  .option('--agent-id <id>')
+  .action((path, opts) => {
+    try { out(claim(path, { agentId: opts.agentId }) ?? { empty: true }); }
+    catch (e) { fail(e instanceof Error ? e.message : String(e)); }
+  });
+
+program
+  .command('release <queue> <id>')
+  .option('--target <subqueue>')
+  .option('--payload', 'read payload from stdin')
+  .option('--replace')
+  .action((queue, id, opts) => {
+    try {
+      const releaseOpts: ReleaseOptions = { target: opts.target, replace: opts.replace };
+      if (opts.payload) releaseOpts.payload = readStdin() ?? undefined;
+      release(queue, id, releaseOpts);
+      out({ ok: true });
+    } catch (e) { e instanceof QQError ? fail(e.message) : fail(String(e)); }
+  });
+
+addFilterOptions(program.command('list <path>'))
+  .action((path, opts) => {
+    try { out(list(path, collectFilters(opts))); }
+    catch (e) { fail(e instanceof Error ? e.message : String(e)); }
+  });
+
+addFilterOptions(program.command('batch-read <path>'))
+  .action((path, opts) => {
+    try { out(batchRead(path, collectFilters(opts))); }
+    catch (e) { fail(e instanceof Error ? e.message : String(e)); }
+  });
+
+program
+  .command('stats <queue>')
+  .action((queue) => {
+    try { out(stats(queue)); }
+    catch (e) { fail(e instanceof Error ? e.message : String(e)); }
+  });
+
+program
+  .command('reap <queue> [agent-id]')
+  .action((queue, agentId) => {
+    try { out({ reaped: reap(queue, agentId) }); }
+    catch (e) { fail(e instanceof Error ? e.message : String(e)); }
+  });
+
+program.parse();