@telepat/snoopy 0.1.11 → 0.1.12

package/README.md

@@ -1,10 +1,6 @@
-```text
-┌─┐┌┐┌┌─┐┌─┐┌─┐┬ ┬
-└─┐││││ ││ │├─┘└┬┘
-└─┘┘└┘└─┘└─┘┴   ┴ 
-```
-
-# Monitor Reddit Conversations With AI
+<p align="center"><img src="./snoopy-logo.webp" width="128" alt="Snoopy"></p>
+<h1 align="center">Snoopy</h1>
+<p align="center"><em>Sniff out the conversations that matter.</em></p>
 
 [![Build](https://img.shields.io/github/actions/workflow/status/telepat-io/snoopy/ci.yml?branch=main&label=build)](https://github.com/telepat-io/snoopy/actions/workflows/ci.yml)
 [![Coverage](https://codecov.io/gh/telepat-io/snoopy/graph/badge.svg)](https://codecov.io/gh/telepat-io/snoopy)
@@ -159,7 +155,15 @@ snoopy export
 snoopy export <jobRef> --json --last-run
 ```
 
-8. Inspect one run's detailed log output:
+8. Consume unconsumed qualified results (read-once, most recent first):
+
+```bash
+snoopy consume
+snoopy consume <jobRef> --limit 10
+snoopy consume <jobRef> --json --dry-run
+```
+
+9. Inspect one run's detailed log output:
 
 ```bash
 snoopy logs
@@ -169,13 +173,13 @@ snoopy logs <runId> --raw
 
 When `runId` is omitted for `logs`, Snoopy first prompts for a job, then prompts for a run from that job (up/down arrows + Enter).
 
-9. Show recent errors for one job:
+10. Show recent errors for one job:
 
 ```bash
 snoopy errors <jobRef>
 ```
 
-10. Enable daemon mode:
+11. Enable daemon mode:
 
 ```bash
 snoopy daemon start
@@ -191,6 +195,7 @@ snoopy daemon reload
 - `analytics [jobRef] --days <N>`
 - `results [jobRef]`
 - `export [jobRef] --csv|--json [--last-run]`
+- `consume [jobRef] [--limit <N>] [--json] [--dry-run]`
 - `logs [runId]`
 - `errors [jobRef] --hours <N>`
 - `start [jobRef]` / `stop [jobRef]`

package/dist/src/cli/commands/consume.d.ts

@@ -0,0 +1,7 @@
+interface ConsumeCommandOptions {
+    limit?: number;
+    json?: boolean;
+    dryRun?: boolean;
+}
+export declare function consumeResults(jobRef?: string, options?: ConsumeCommandOptions): void;
+export {};

package/dist/src/cli/commands/consume.js

@@ -0,0 +1,60 @@
+import { JobsRepository } from '../../services/db/repositories/jobsRepo.js';
+import { ScanItemsRepository } from '../../services/db/repositories/scanItemsRepo.js';
+import { printCommandScreen, printError, printInfo, printKeyValue, printMuted, printSuccess, printWarning } from '../ui/consoleUi.js';
+function truncateContent(content, maxLength) {
+    if (content.length <= maxLength) {
+        return content;
+    }
+    return `${content.slice(0, maxLength)}...`;
+}
+function renderResultRow(row, index) {
+    printInfo(`#${index + 1}`);
+    printKeyValue('Job', row.jobId);
+    printKeyValue('Author', row.author);
+    if (row.title) {
+        printKeyValue('Title', row.title);
+    }
+    printKeyValue('URL', row.url);
+    printKeyValue('Date', row.redditPostedAt);
+    if (row.qualificationReason) {
+        printKeyValue('Reason', truncateContent(row.qualificationReason, 120));
+    }
+    printMuted(truncateContent(row.body, 200));
+    console.log('');
+}
+export function consumeResults(jobRef, options = {}) {
+    printCommandScreen('Consume results', 'List and consume unconsumed qualified results');
+    const jobsRepo = new JobsRepository();
+    const scanItemsRepo = new ScanItemsRepository();
+    let jobId;
+    if (jobRef) {
+        const job = jobsRepo.getByRef(jobRef);
+        if (!job) {
+            printError(`Job not found: ${jobRef}`);
+            return;
+        }
+        jobId = job.id;
+    }
+    const rows = scanItemsRepo.listUnconsumedQualified(jobId, options.limit);
+    if (rows.length === 0) {
+        if (options.json) {
+            console.log(JSON.stringify([], null, 2));
+            return;
+        }
+        printWarning('No unconsumed qualified results found.');
+        return;
+    }
+    if (options.json) {
+        console.log(JSON.stringify(rows, null, 2));
+    }
+    else {
+        rows.forEach((row, index) => renderResultRow(row, index));
+    }
+    if (options.dryRun) {
+        printSuccess(`Found ${rows.length} result(s) (dry run — not consumed).`);
+        return;
+    }
+    const consumedCount = scanItemsRepo.markConsumed(rows.map((r) => r.id));
+    printSuccess(`Consumed ${consumedCount} result(s).`);
+}
+//# sourceMappingURL=consume.js.map

package/dist/src/cli/index.js

@@ -7,6 +7,7 @@ import { daemonReload, daemonRun, daemonStart, daemonStatus, daemonStop } from '
 import { showRunLogs } from './commands/logs.js';
 import { showJobErrors } from './commands/errors.js';
 import { exportCsv } from './commands/export.js';
+import { consumeResults } from './commands/consume.js';
 import { showAnalytics } from './commands/analytics.js';
 import { showResults } from './commands/results.js';
 import { disableStartupCommand, enableStartupCommand, installStartupCommand, startupStatusCommand, uninstallStartupCommand } from './commands/startup.js';
@@ -142,6 +143,16 @@ program
     .action((jobRef, options) => {
     exportCsv(jobRef, options);
 });
+program
+    .command('consume')
+    .argument('[jobRef]', 'Optional job ID or slug')
+    .description('List and mark unconsumed qualified results')
+    .option('--limit <count>', 'Maximum number of results to consume', parsePositiveInteger)
+    .option('--json', 'Output raw JSON array to stdout')
+    .option('--dry-run', 'Preview results without marking them consumed')
+    .action((jobRef, options) => {
+    consumeResults(jobRef, options);
+});
 program.parseAsync(process.argv).catch((error) => {
     console.error(`Error: ${String(error)}`);
     process.exit(1);

package/dist/src/services/db/repositories/scanItemsRepo.d.ts

@@ -15,6 +15,7 @@ export interface NewScanItem {
     viewed?: boolean;
     validated?: boolean;
     processed?: boolean;
+    consumed?: boolean;
     promptTokens?: number;
     completionTokens?: number;
     estimatedCostUsd?: number | null;
@@ -46,6 +47,7 @@ export interface QualifiedScanItemRow {
     viewed: boolean;
     validated: boolean;
     processed: boolean;
+    consumed: boolean;
     qualificationReason: string | null;
     createdAt: string;
 }
@@ -66,6 +68,7 @@ export interface ScanItemRow {
     viewed: boolean;
     validated: boolean;
     processed: boolean;
+    consumed: boolean;
     qualificationReason: string | null;
     promptTokens: number;
     completionTokens: number;
@@ -113,6 +116,8 @@ export declare class ScanItemsRepository {
     listAnalyticsBySubreddit(filter: AnalyticsFilter): AnalyticsBySubredditRow[];
     listAnalyticsByJob(days: number): AnalyticsByJobRow[];
     existsComment(jobId: string, postId: string, commentId: string): boolean;
+    listUnconsumedQualified(jobId?: string, limit?: number): QualifiedScanItemRow[];
+    markConsumed(ids: string[]): number;
     createWithStatus(item: NewScanItem): CreateScanItemResult;
     create(item: NewScanItem): string;
     listCommentThreadNodes(scanItemId: string): CommentThreadNodeRow[];

package/dist/src/services/db/repositories/scanItemsRepo.js

@@ -31,7 +31,8 @@ export class ScanItemsRepository {
             qualified: row.qualified === 1,
             viewed: row.viewed === 1,
             validated: row.validated === 1,
-            processed: row.processed === 1
+            processed: row.processed === 1,
+            consumed: row.consumed === 1
         }));
     }
     buildFilterClause(alias, filter) {
@@ -70,6 +71,7 @@ export class ScanItemsRepository {
            viewed,
            validated,
            processed,
+           consumed,
            qualification_reason as qualificationReason,
            created_at as createdAt
          FROM scan_items
@@ -82,7 +84,8 @@ export class ScanItemsRepository {
             ...row,
             viewed: row.viewed === 1,
             validated: row.validated === 1,
-            processed: row.processed === 1
+            processed: row.processed === 1,
+            consumed: row.consumed === 1
         }));
     }
     listQualifiedByJobRun(jobId, runId, limit = 100) {
@@ -100,6 +103,7 @@ export class ScanItemsRepository {
            viewed,
            validated,
            processed,
+           consumed,
            qualification_reason as qualificationReason,
            created_at as createdAt
          FROM scan_items
@@ -113,7 +117,8 @@ export class ScanItemsRepository {
             ...row,
             viewed: row.viewed === 1,
             validated: row.validated === 1,
-            processed: row.processed === 1
+            processed: row.processed === 1,
+            consumed: row.consumed === 1
         }));
     }
     listByJob(jobId) {
@@ -135,6 +140,7 @@ export class ScanItemsRepository {
            viewed,
            validated,
            processed,
+           consumed,
            qualification_reason as qualificationReason,
            prompt_tokens as promptTokens,
            completion_tokens as completionTokens,
@@ -175,6 +181,7 @@ export class ScanItemsRepository {
            viewed,
            validated,
            processed,
+           consumed,
            qualification_reason as qualificationReason,
            prompt_tokens as promptTokens,
            completion_tokens as completionTokens,
@@ -283,6 +290,56 @@ export class ScanItemsRepository {
             .get(jobId, postId, commentId);
         return Boolean(row);
     }
+    listUnconsumedQualified(jobId, limit) {
+        const hasJobId = Boolean(jobId);
+        const hasLimit = limit !== undefined && limit !== null;
+        const boundedLimit = hasLimit ? Math.max(1, Math.floor(limit)) : undefined;
+        let query = `SELECT
+           id,
+           job_id as jobId,
+           run_id as runId,
+           author,
+           title,
+           body,
+           url,
+           reddit_posted_at as redditPostedAt,
+           viewed,
+           validated,
+           processed,
+           consumed,
+           qualification_reason as qualificationReason,
+           created_at as createdAt
+         FROM scan_items
+         WHERE qualified = 1 AND consumed = 0`;
+        const params = [];
+        if (hasJobId) {
+            query += ' AND job_id = ?';
+            params.push(jobId);
+        }
+        query += ' ORDER BY datetime(created_at) DESC, id DESC';
+        if (boundedLimit !== undefined) {
+            query += ' LIMIT ?';
+            params.push(boundedLimit);
+        }
+        const rows = this.db.prepare(query).all(...params);
+        return rows.map((row) => ({
+            ...row,
+            viewed: row.viewed === 1,
+            validated: row.validated === 1,
+            processed: row.processed === 1,
+            consumed: row.consumed === 1
+        }));
+    }
+    markConsumed(ids) {
+        if (ids.length === 0) {
+            return 0;
+        }
+        const placeholders = ids.map(() => '?').join(',');
+        const result = this.db
+            .prepare(`UPDATE scan_items SET consumed = 1 WHERE id IN (${placeholders})`)
+            .run(...ids);
+        return Number(result.changes);
+    }
     createWithStatus(item) {
         const id = crypto.randomUUID();
         const createInTransaction = this.db.transaction((newId, newItem) => {
@@ -304,13 +361,14 @@ export class ScanItemsRepository {
             viewed,
             validated,
             processed,
+            consumed,
             prompt_tokens,
             completion_tokens,
             estimated_cost_usd,
             qualification_reason,
             created_at
-          ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))`)
-                .run(newId, newItem.jobId, newItem.runId, newItem.type, newItem.redditPostId, newItem.redditCommentId, newItem.subreddit, newItem.author, newItem.title, newItem.body, newItem.url, newItem.redditPostedAt, newItem.qualified ? 1 : 0, newItem.viewed ? 1 : 0, newItem.validated ? 1 : 0, newItem.processed ? 1 : 0, newItem.promptTokens ?? 0, newItem.completionTokens ?? 0, newItem.estimatedCostUsd ?? null, newItem.qualificationReason);
+          ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))`)
+                .run(newId, newItem.jobId, newItem.runId, newItem.type, newItem.redditPostId, newItem.redditCommentId, newItem.subreddit, newItem.author, newItem.title, newItem.body, newItem.url, newItem.redditPostedAt, newItem.qualified ? 1 : 0, newItem.viewed ? 1 : 0, newItem.validated ? 1 : 0, newItem.processed ? 1 : 0, newItem.consumed ? 1 : 0, newItem.promptTokens ?? 0, newItem.completionTokens ?? 0, newItem.estimatedCostUsd ?? null, newItem.qualificationReason);
             if (insertResult.changes === 0) {
                 const existingId = this.findExistingScanItemId(newItem.jobId, newItem.redditPostId, newItem.redditCommentId);
                 return {

package/dist/src/services/db/sqlite.js

@@ -68,6 +68,7 @@ export function getDb() {
       viewed INTEGER NOT NULL DEFAULT 0,
       validated INTEGER NOT NULL DEFAULT 0,
       processed INTEGER NOT NULL DEFAULT 0,
+      consumed INTEGER NOT NULL DEFAULT 0,
       prompt_tokens INTEGER NOT NULL DEFAULT 0,
       completion_tokens INTEGER NOT NULL DEFAULT 0,
       estimated_cost_usd REAL,
@@ -206,6 +207,13 @@ export function getDb() {
     catch {
         // Column already exists.
     }
+    try {
+        db.exec('ALTER TABLE scan_items ADD COLUMN consumed INTEGER NOT NULL DEFAULT 0');
+    }
+    catch {
+        // Column already exists.
+    }
+    db.exec('CREATE INDEX IF NOT EXISTS idx_scan_items_consumed ON scan_items(job_id, qualified, consumed, created_at DESC)');
     return db;
 }
 //# sourceMappingURL=sqlite.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telepat/snoopy",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "Snoopy CLI for Reddit conversation monitoring jobs.",
   "type": "module",
   "main": "dist/src/index.js",