@telepat/snoopy 0.1.14 → 0.1.15

package/dist/src/mcp/helpers.js

@@ -1,23 +1,37 @@
-import { createRequire } from 'node:module';
+import fs from 'node:fs';
+import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { getDb } from '../services/db/sqlite.js';
 import { JobsRepository } from '../services/db/repositories/jobsRepo.js';
 import { RunsRepository } from '../services/db/repositories/runsRepo.js';
 import { ScanItemsRepository } from '../services/db/repositories/scanItemsRepo.js';
 import { SettingsRepository } from '../services/db/repositories/settingsRepo.js';
+import { consolidateFeedback } from '../services/feedback/consolidationService.js';
 import { AnalyticsService } from '../services/analytics/analyticsService.js';
 import { extractErrorEntries, readRunLog } from '../services/logging/logReader.js';
 import { getOpenRouterApiKey, isKeytarAvailable } from '../services/security/secretStore.js';
 import { getStartupStatus } from '../services/startup/index.js';
 import { isDaemonRunning, ensureDaemonRunning, requestDaemonReload } from '../services/daemonControl.js';
 import { ensureAppDirs } from '../utils/paths.js';
-const require = createRequire(import.meta.url);
 export function getSnoopyVersion() {
-    for (const rel of ['../../../package.json', '../../package.json']) {
+    const envVersion = process.env.npm_package_version;
+    if (envVersion) {
+        return envVersion;
+    }
+    const argvDir = process.argv[1] ? path.dirname(process.argv[1]) : process.cwd();
+    const candidates = [
+        path.resolve(process.cwd(), 'package.json'),
+        path.resolve(process.cwd(), 'snoopy/package.json'),
+        path.resolve(argvDir, '../package.json'),
+        path.resolve(argvDir, '../../package.json'),
+    ];
+    for (const candidate of candidates) {
         try {
-            const pkg = require(rel);
-            if (pkg.name === '@telepat/snoopy')
+            const raw = fs.readFileSync(candidate, 'utf8');
+            const pkg = JSON.parse(raw);
+            if (pkg.name === '@telepat/snoopy') {
                 return pkg.version ?? '0.0.0';
+            }
         }
         catch { /* try next depth */ }
     }
@@ -308,6 +322,65 @@ export function consumeReport(jobRef, limit, dryRun) {
     const consumedCount = scanItemsRepo.markConsumed(rows.map((r) => r.id));
     return { consumed: consumedCount, items: rows };
 }
+export function feedbackReviewReport(jobRef, limit) {
+    const jobsRepo = new JobsRepository();
+    const scanItemsRepo = new ScanItemsRepository();
+    let jobId;
+    if (jobRef) {
+        const job = jobsRepo.getByRef(jobRef);
+        if (!job) {
+            throw new Error(`Job not found: ${jobRef}`);
+        }
+        jobId = job.id;
+    }
+    const boundedLimit = limit ?? 10;
+    const items = scanItemsRepo.listUnvalidatedQualified(jobId, boundedLimit);
+    return {
+        count: items.length,
+        limit: boundedLimit,
+        items,
+        workflow: {
+            nextStep: 'collect-user-feedback-and-call-snoopy_feedback_submit',
+            then: 'call-snoopy_feedback_consolidate'
+        }
+    };
+}
+export function feedbackSubmitReport(resultId, isValid, reason) {
+    const scanItemsRepo = new ScanItemsRepository();
+    const row = scanItemsRepo.getQualifiedById(resultId);
+    if (!row) {
+        throw new Error(`Qualified result not found: ${resultId}`);
+    }
+    const normalizedReason = reason?.trim() ?? '';
+    if (!isValid && normalizedReason.length === 0) {
+        throw new Error('reason is required when isValid=false');
+    }
+    const updated = scanItemsRepo.submitFeedback(resultId, isValid, isValid ? null : normalizedReason);
+    if (!updated) {
+        throw new Error(`Failed to save feedback for result: ${resultId}`);
+    }
+    const pendingFeedbackConsolidationCount = scanItemsRepo.countPendingFeedbackConsolidation(row.jobId);
+    return {
+        resultId,
+        saved: true,
+        feedback: {
+            validated: true,
+            isValid,
+            isValidReason: isValid ? null : normalizedReason,
+            feedbackConsolidated: false,
+        },
+        pendingFeedbackConsolidationCount,
+        requiresConsolidation: pendingFeedbackConsolidationCount > 0,
+        recommendedNextCommand: 'snoopy feedback consolidate',
+    };
+}
+export async function feedbackConsolidateReport(jobRef, limit) {
+    const result = await consolidateFeedback({ jobRef, limit });
+    return {
+        ...result,
+        recommendedNextAction: result.requiresConsolidation ? 'run snoopy feedback consolidate again' : 'none',
+    };
+}
 export function errorsReport(jobRef, hours) {
     const jobsRepo = new JobsRepository();
     const runsRepo = new RunsRepository();

package/dist/src/mcp/server.js

@@ -1,7 +1,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { snoopyDoctorToolInputSchema, snoopyDaemonStatusToolInputSchema, snoopyDaemonStartToolInputSchema, snoopyDaemonStopToolInputSchema, snoopyDaemonReloadToolInputSchema, snoopyJobListToolInputSchema, snoopyJobRunsToolInputSchema, snoopyJobAddToolInputSchema, snoopyJobDeleteToolInputSchema, snoopyJobEnableToolInputSchema, snoopyJobDisableToolInputSchema, snoopyJobRunToolInputSchema, snoopyAnalyticsToolInputSchema, snoopyExportToolInputSchema, snoopyConsumeToolInputSchema, snoopyErrorsToolInputSchema, snoopyLogsToolInputSchema, snoopySettingsGetToolInputSchema, snoopySettingsSetToolInputSchema, } from './tools.js';
-import { getSnoopyVersion, formatToolError, formatToolResult, buildDoctorReport, buildDaemonStatusReport, startDaemonReport, stopDaemonReport, reloadDaemonReport, listJobsReport, listJobRunsReport, addJobReport, deleteJobReport, enableJobReport, disableJobReport, runJobReport, analyticsReport, exportReport, consumeReport, errorsReport, logsReport, settingsGetReport, settingsSetReport, } from './helpers.js';
+import { snoopyDoctorToolInputSchema, snoopyDaemonStatusToolInputSchema, snoopyDaemonStartToolInputSchema, snoopyDaemonStopToolInputSchema, snoopyDaemonReloadToolInputSchema, snoopyJobListToolInputSchema, snoopyJobRunsToolInputSchema, snoopyJobAddToolInputSchema, snoopyJobDeleteToolInputSchema, snoopyJobEnableToolInputSchema, snoopyJobDisableToolInputSchema, snoopyJobRunToolInputSchema, snoopyAnalyticsToolInputSchema, snoopyExportToolInputSchema, snoopyConsumeToolInputSchema, snoopyFeedbackReviewToolInputSchema, snoopyFeedbackSubmitToolInputSchema, snoopyFeedbackConsolidateToolInputSchema, snoopyErrorsToolInputSchema, snoopyLogsToolInputSchema, snoopySettingsGetToolInputSchema, snoopySettingsSetToolInputSchema, } from './tools.js';
+import { getSnoopyVersion, formatToolError, formatToolResult, buildDoctorReport, buildDaemonStatusReport, startDaemonReport, stopDaemonReport, reloadDaemonReport, listJobsReport, listJobRunsReport, addJobReport, deleteJobReport, enableJobReport, disableJobReport, runJobReport, analyticsReport, exportReport, consumeReport, feedbackReviewReport, feedbackSubmitReport, feedbackConsolidateReport, errorsReport, logsReport, settingsGetReport, settingsSetReport, } from './helpers.js';
 export async function startSnoopyMcpServer() {
     const version = getSnoopyVersion();
     const server = new McpServer({ name: 'snoopy', version });
@@ -201,6 +201,45 @@ export async function startSnoopyMcpServer() {
             return formatToolError(error);
         }
     });
+    // --- snoopy_feedback_review ---
+    server.registerTool('snoopy_feedback_review', {
+        title: 'Review Feedback Queue',
+        description: 'List unvalidated qualified results for user feedback collection.',
+        inputSchema: snoopyFeedbackReviewToolInputSchema,
+    }, (input) => {
+        try {
+            return formatToolResult(feedbackReviewReport(input.jobRef, input.limit));
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
+    });
+    // --- snoopy_feedback_submit ---
+    server.registerTool('snoopy_feedback_submit', {
+        title: 'Submit Feedback',
+        description: 'Submit validity feedback for a qualified result.',
+        inputSchema: snoopyFeedbackSubmitToolInputSchema,
+    }, (input) => {
+        try {
+            return formatToolResult(feedbackSubmitReport(input.resultId, input.isValid, input.reason));
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
+    });
+    // --- snoopy_feedback_consolidate ---
+    server.registerTool('snoopy_feedback_consolidate', {
+        title: 'Consolidate Feedback',
+        description: 'Consolidate feedback into improved qualification prompts.',
+        inputSchema: snoopyFeedbackConsolidateToolInputSchema,
+    }, async (input) => {
+        try {
+            return formatToolResult(await feedbackConsolidateReport(input.jobRef, input.limit));
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
+    });
     // --- snoopy_errors ---
     server.registerTool('snoopy_errors', {
         title: 'Recent Errors',

package/dist/src/mcp/tools.d.ts

@@ -49,6 +49,19 @@ export declare const snoopyConsumeToolInputSchema: {
     limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
     dryRun: z.ZodOptional<z.ZodBoolean>;
 };
+export declare const snoopyFeedbackReviewToolInputSchema: {
+    jobRef: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+};
+export declare const snoopyFeedbackSubmitToolInputSchema: {
+    resultId: z.ZodString;
+    isValid: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+};
+export declare const snoopyFeedbackConsolidateToolInputSchema: {
+    jobRef: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+};
 export declare const snoopyErrorsToolInputSchema: {
     jobRef: z.ZodString;
     hours: z.ZodOptional<z.ZodCoercedNumber<unknown>>;

package/dist/src/mcp/tools.js

@@ -46,6 +46,19 @@ export const snoopyConsumeToolInputSchema = {
     limit: z.coerce.number().int().positive().optional().describe('Max results to consume.'),
     dryRun: z.boolean().optional().describe('Preview without marking consumed.'),
 };
+export const snoopyFeedbackReviewToolInputSchema = {
+    jobRef: z.string().optional().describe('Job ID or slug. If omitted, review queue spans all jobs.'),
+    limit: z.coerce.number().int().positive().optional().describe('Max unvalidated results to return. Default: 10.'),
+};
+export const snoopyFeedbackSubmitToolInputSchema = {
+    resultId: z.string().min(1).describe('Qualified result ID to update.'),
+    isValid: z.boolean().describe('Whether the result should be considered valid.'),
+    reason: z.string().optional().describe('Required when isValid=false; ignored when isValid=true.'),
+};
+export const snoopyFeedbackConsolidateToolInputSchema = {
+    jobRef: z.string().optional().describe('Job ID or slug. If omitted, consolidates across all jobs.'),
+    limit: z.coerce.number().int().positive().optional().describe('Max pending feedback items to process.'),
+};
 export const snoopyErrorsToolInputSchema = {
     jobRef: z.string().min(1).describe('Job ID or slug.'),
     hours: z.coerce.number().int().positive().optional().describe('Look back hours. Default: 24.'),
@@ -82,6 +95,9 @@ export const snoopyToolContracts = [
     { name: 'snoopy_analytics', required: [], enums: {} },
     { name: 'snoopy_export', required: [], enums: { format: ['json', 'csv'] } },
     { name: 'snoopy_consume', required: [], enums: {} },
+    { name: 'snoopy_feedback_review', required: [], enums: {} },
+    { name: 'snoopy_feedback_submit', required: ['resultId', 'isValid'], enums: {} },
+    { name: 'snoopy_feedback_consolidate', required: [], enums: {} },
     { name: 'snoopy_errors', required: ['jobRef'], enums: {} },
     { name: 'snoopy_logs', required: ['runId'], enums: {} },
     { name: 'snoopy_settings_get', required: [], enums: {} },

package/dist/src/services/db/migrations/002_feedback_fields.d.ts

@@ -0,0 +1,7 @@
+import type Database from 'better-sqlite3';
+declare const _default: {
+    id: number;
+    name: string;
+    up(db: Database.Database): void;
+};
+export default _default;

package/dist/src/services/db/migrations/002_feedback_fields.js

@@ -0,0 +1,22 @@
+export default {
+    id: 2,
+    name: 'feedback_fields',
+    up(db) {
+        const safeAddColumn = (table, column, type) => {
+            try {
+                db.exec(`ALTER TABLE ${table} ADD COLUMN ${column} ${type}`);
+            }
+            catch {
+                // Column already exists or table does not exist.
+            }
+        };
+        safeAddColumn('scan_items', 'is_valid', 'INTEGER NOT NULL DEFAULT 0');
+        safeAddColumn('scan_items', 'is_valid_reason', 'TEXT');
+        safeAddColumn('scan_items', 'feedback_consolidated', 'INTEGER NOT NULL DEFAULT 0');
+        db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_scan_items_feedback_pending
+      ON scan_items(job_id, qualified, validated, feedback_consolidated, created_at DESC)
+    `);
+    }
+};
+//# sourceMappingURL=002_feedback_fields.js.map

package/dist/src/services/db/migrations/index.js

@@ -1,3 +1,4 @@
 import baseline from './001_baseline.js';
-export const migrations = [baseline];
+import feedbackFields from './002_feedback_fields.js';
+export const migrations = [baseline, feedbackFields];
 //# sourceMappingURL=index.js.map

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

@@ -28,6 +28,8 @@ export declare class JobsRepository {
     listEnabled(): Job[];
     setEnabled(id: string, enabled: boolean): void;
     setEnabledByRef(ref: string, enabled: boolean): Job | null;
+    updateQualificationPromptById(id: string, qualificationPrompt: string): Job | null;
+    updateQualificationPromptByRef(ref: string, qualificationPrompt: string): Job | null;
     remove(id: string): void;
     removeByRef(ref: string): Job | null;
     listWithStats(): JobSummaryRow[];

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

@@ -141,6 +141,21 @@ export class JobsRepository {
         this.setEnabled(job.id, enabled);
         return this.getById(job.id);
     }
+    updateQualificationPromptById(id, qualificationPrompt) {
+        this.db
+            .prepare(`UPDATE jobs
+         SET qualification_prompt = ?, updated_at = datetime('now')
+         WHERE id = ?`)
+            .run(qualificationPrompt, id);
+        return this.getById(id);
+    }
+    updateQualificationPromptByRef(ref, qualificationPrompt) {
+        const job = this.getByRef(ref);
+        if (!job) {
+            return null;
+        }
+        return this.updateQualificationPromptById(job.id, qualificationPrompt);
+    }
     remove(id) {
         this.removeCascadeStmt(id);
     }

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

@@ -14,6 +14,9 @@ export interface NewScanItem {
     qualified: boolean;
     viewed?: boolean;
     validated?: boolean;
+    isValid?: boolean;
+    isValidReason?: string | null;
+    feedbackConsolidated?: boolean;
     processed?: boolean;
     consumed?: boolean;
     promptTokens?: number;
@@ -39,6 +42,8 @@ export interface QualifiedScanItemRow {
     id: string;
     jobId: string;
     runId: string;
+    type: ScanItemType;
+    subreddit: string;
     author: string;
     title: string | null;
     body: string;
@@ -46,6 +51,9 @@ export interface QualifiedScanItemRow {
     redditPostedAt: string;
     viewed: boolean;
     validated: boolean;
+    isValid: boolean;
+    isValidReason: string | null;
+    feedbackConsolidated: boolean;
     processed: boolean;
     consumed: boolean;
     qualificationReason: string | null;
@@ -67,6 +75,9 @@ export interface ScanItemRow {
     qualified: boolean;
     viewed: boolean;
     validated: boolean;
+    isValid: boolean;
+    isValidReason: string | null;
+    feedbackConsolidated: boolean;
     processed: boolean;
     consumed: boolean;
     qualificationReason: string | null;
@@ -117,6 +128,12 @@ export declare class ScanItemsRepository {
     listAnalyticsByJob(days: number): AnalyticsByJobRow[];
     existsComment(jobId: string, postId: string, commentId: string): boolean;
     listUnconsumedQualified(jobId?: string, limit?: number): QualifiedScanItemRow[];
+    getQualifiedById(id: string): QualifiedScanItemRow | null;
+    listUnvalidatedQualified(jobId?: string, limit?: number): QualifiedScanItemRow[];
+    submitFeedback(resultId: string, isValid: boolean, reason: string | null): boolean;
+    listPendingFeedbackConsolidation(jobId?: string, limit?: number): QualifiedScanItemRow[];
+    countPendingFeedbackConsolidation(jobId?: string): number;
+    markFeedbackConsolidated(ids: string[]): number;
     markConsumed(ids: string[]): number;
     createWithStatus(item: NewScanItem): CreateScanItemResult;
     create(item: NewScanItem): string;

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

@@ -31,6 +31,8 @@ export class ScanItemsRepository {
             qualified: row.qualified === 1,
             viewed: row.viewed === 1,
             validated: row.validated === 1,
+            isValid: row.isValid === 1,
+            feedbackConsolidated: row.feedbackConsolidated === 1,
             processed: row.processed === 1,
             consumed: row.consumed === 1
         }));
@@ -63,6 +65,8 @@ export class ScanItemsRepository {
            id,
            job_id as jobId,
            run_id as runId,
+            type,
+            subreddit,
            author,
            title,
            body,
@@ -70,6 +74,9 @@ export class ScanItemsRepository {
            reddit_posted_at as redditPostedAt,
            viewed,
            validated,
+            is_valid as isValid,
+            is_valid_reason as isValidReason,
+            feedback_consolidated as feedbackConsolidated,
            processed,
            consumed,
            qualification_reason as qualificationReason,
@@ -84,6 +91,8 @@ export class ScanItemsRepository {
             ...row,
             viewed: row.viewed === 1,
             validated: row.validated === 1,
+            isValid: row.isValid === 1,
+            feedbackConsolidated: row.feedbackConsolidated === 1,
             processed: row.processed === 1,
             consumed: row.consumed === 1
         }));
@@ -95,6 +104,8 @@ export class ScanItemsRepository {
            id,
            job_id as jobId,
            run_id as runId,
+            type,
+            subreddit,
            author,
            title,
            body,
@@ -102,6 +113,9 @@ export class ScanItemsRepository {
            reddit_posted_at as redditPostedAt,
            viewed,
            validated,
+            is_valid as isValid,
+            is_valid_reason as isValidReason,
+            feedback_consolidated as feedbackConsolidated,
            processed,
            consumed,
            qualification_reason as qualificationReason,
@@ -117,6 +131,8 @@ export class ScanItemsRepository {
             ...row,
             viewed: row.viewed === 1,
             validated: row.validated === 1,
+            isValid: row.isValid === 1,
+            feedbackConsolidated: row.feedbackConsolidated === 1,
             processed: row.processed === 1,
             consumed: row.consumed === 1
         }));
@@ -139,6 +155,9 @@ export class ScanItemsRepository {
            qualified,
            viewed,
            validated,
+           is_valid as isValid,
+           is_valid_reason as isValidReason,
+           feedback_consolidated as feedbackConsolidated,
            processed,
            consumed,
            qualification_reason as qualificationReason,
@@ -180,6 +199,9 @@ export class ScanItemsRepository {
            qualified,
            viewed,
            validated,
+           is_valid as isValid,
+           is_valid_reason as isValidReason,
+           feedback_consolidated as feedbackConsolidated,
            processed,
            consumed,
            qualification_reason as qualificationReason,
@@ -298,6 +320,8 @@ export class ScanItemsRepository {
            id,
            job_id as jobId,
            run_id as runId,
+          type,
+          subreddit,
            author,
            title,
            body,
@@ -305,6 +329,9 @@ export class ScanItemsRepository {
            reddit_posted_at as redditPostedAt,
            viewed,
            validated,
+          is_valid as isValid,
+          is_valid_reason as isValidReason,
+          feedback_consolidated as feedbackConsolidated,
            processed,
            consumed,
            qualification_reason as qualificationReason,
@@ -326,10 +353,175 @@ export class ScanItemsRepository {
             ...row,
             viewed: row.viewed === 1,
             validated: row.validated === 1,
+            isValid: row.isValid === 1,
+            feedbackConsolidated: row.feedbackConsolidated === 1,
             processed: row.processed === 1,
             consumed: row.consumed === 1
         }));
     }
+    getQualifiedById(id) {
+        const rows = this.db
+            .prepare(`SELECT
+           id,
+           job_id as jobId,
+           run_id as runId,
+           type,
+           subreddit,
+           author,
+           title,
+           body,
+           url,
+           reddit_posted_at as redditPostedAt,
+           viewed,
+           validated,
+           is_valid as isValid,
+           is_valid_reason as isValidReason,
+           feedback_consolidated as feedbackConsolidated,
+           processed,
+           consumed,
+           qualification_reason as qualificationReason,
+           created_at as createdAt
+         FROM scan_items
+         WHERE id = ?
+           AND qualified = 1
+         LIMIT 1`)
+            .all(id);
+        const row = rows[0];
+        if (!row) {
+            return null;
+        }
+        return {
+            ...row,
+            viewed: row.viewed === 1,
+            validated: row.validated === 1,
+            isValid: row.isValid === 1,
+            feedbackConsolidated: row.feedbackConsolidated === 1,
+            processed: row.processed === 1,
+            consumed: row.consumed === 1
+        };
+    }
+    listUnvalidatedQualified(jobId, limit = 10) {
+        const boundedLimit = Math.max(1, Math.floor(limit));
+        const rows = this.db
+            .prepare(`SELECT
+           id,
+           job_id as jobId,
+           run_id as runId,
+           type,
+           subreddit,
+           author,
+           title,
+           body,
+           url,
+           reddit_posted_at as redditPostedAt,
+           viewed,
+           validated,
+           is_valid as isValid,
+           is_valid_reason as isValidReason,
+           feedback_consolidated as feedbackConsolidated,
+           processed,
+           consumed,
+           qualification_reason as qualificationReason,
+           created_at as createdAt
+         FROM scan_items
+         WHERE qualified = 1
+           AND validated = 0
+           ${jobId ? 'AND job_id = ?' : ''}
+         ORDER BY datetime(created_at) DESC, id DESC
+         LIMIT ?`)
+            .all(...(jobId ? [jobId, boundedLimit] : [boundedLimit]));
+        return rows.map((row) => ({
+            ...row,
+            viewed: row.viewed === 1,
+            validated: row.validated === 1,
+            isValid: row.isValid === 1,
+            feedbackConsolidated: row.feedbackConsolidated === 1,
+            processed: row.processed === 1,
+            consumed: row.consumed === 1
+        }));
+    }
+    submitFeedback(resultId, isValid, reason) {
+        const normalizedReason = reason?.trim() ?? null;
+        const result = this.db
+            .prepare(`UPDATE scan_items
+         SET validated = 1,
+             is_valid = ?,
+             is_valid_reason = ?,
+             feedback_consolidated = 0
+         WHERE id = ?
+           AND qualified = 1`)
+            .run(isValid ? 1 : 0, normalizedReason, resultId);
+        return Number(result.changes) > 0;
+    }
+    listPendingFeedbackConsolidation(jobId, limit) {
+        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,
+           type,
+           subreddit,
+           author,
+           title,
+           body,
+           url,
+           reddit_posted_at as redditPostedAt,
+           viewed,
+           validated,
+           is_valid as isValid,
+           is_valid_reason as isValidReason,
+           feedback_consolidated as feedbackConsolidated,
+           processed,
+           consumed,
+           qualification_reason as qualificationReason,
+           created_at as createdAt
+         FROM scan_items
+         WHERE qualified = 1
+           AND validated = 1
+           AND feedback_consolidated = 0`;
+        const params = [];
+        if (jobId) {
+            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,
+            isValid: row.isValid === 1,
+            feedbackConsolidated: row.feedbackConsolidated === 1,
+            processed: row.processed === 1,
+            consumed: row.consumed === 1
+        }));
+    }
+    countPendingFeedbackConsolidation(jobId) {
+        const row = this.db
+            .prepare(`SELECT COUNT(*) as count
+         FROM scan_items
+         WHERE qualified = 1
+           AND validated = 1
+           AND feedback_consolidated = 0
+           ${jobId ? 'AND job_id = ?' : ''}`)
+            .get(...(jobId ? [jobId] : []));
+        return Number(row?.count ?? 0);
+    }
+    markFeedbackConsolidated(ids) {
+        if (ids.length === 0) {
+            return 0;
+        }
+        const placeholders = ids.map(() => '?').join(',');
+        const result = this.db
+            .prepare(`UPDATE scan_items SET feedback_consolidated = 1 WHERE id IN (${placeholders})`)
+            .run(...ids);
+        return Number(result.changes);
+    }
     markConsumed(ids) {
         if (ids.length === 0) {
             return 0;
@@ -360,6 +552,9 @@ export class ScanItemsRepository {
             qualified,
             viewed,
             validated,
+            is_valid,
+            is_valid_reason,
+            feedback_consolidated,
             processed,
             consumed,
             prompt_tokens,
@@ -367,8 +562,8 @@ export class ScanItemsRepository {
             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.consumed ? 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.isValid ? 1 : 0, newItem.isValidReason ?? null, newItem.feedbackConsolidated ? 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/feedback/consolidationService.d.ts

@@ -0,0 +1,28 @@
+export interface ConsolidateFeedbackOptions {
+    jobRef?: string;
+    limit?: number;
+}
+export interface ConsolidateFeedbackJobResult {
+    jobId: string;
+    jobSlug: string;
+    jobName: string;
+    pendingCount: number;
+    consolidatedCount: number;
+    promptUpdated: boolean;
+    oldPrompt?: string;
+    newPrompt?: string;
+    changeSummary?: string[];
+    rationale?: string;
+    promptTokens?: number;
+    completionTokens?: number;
+    error?: string;
+}
+export interface ConsolidateFeedbackResult {
+    jobRef?: string;
+    totalPendingBefore: number;
+    totalPendingAfter: number;
+    totalConsolidated: number;
+    requiresConsolidation: boolean;
+    jobs: ConsolidateFeedbackJobResult[];
+}
+export declare function consolidateFeedback(options?: ConsolidateFeedbackOptions): Promise<ConsolidateFeedbackResult>;