@telepat/snoopy 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 snoopy contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,255 @@
+```text
+┌─┐┌┐┌┌─┐┌─┐┌─┐┬ ┬
+└─┐││││ ││ │├─┘└┬┘
+└─┘┘└┘└─┘└─┘┴   ┴ 
+```
+
+# Monitor Reddit Conversations With AI
+
+[![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://img.shields.io/badge/coverage-94.6%25-brightgreen)](#development)
+[![npm](https://img.shields.io/npm/v/@telepat/snoopy)](https://www.npmjs.com/package/@telepat/snoopy)
+
+📖 [Full documentation](https://docs.telepat.io/ideon/)
+
+Snoopy helps you monitor Reddit for high-intent conversations that match your business goals.
+
+Define what you care about in plain language, let Snoopy create a monitoring job, and continuously scan and qualify posts/comments so you can focus on response and outreach.
+
+## Why Use Snoopy
+
+- Turn broad Reddit traffic into a focused stream of opportunities.
+- Define qualification logic once, then run continuously.
+- Trigger manual runs when you want quick validation.
+- Track run analytics (discovered/new/qualified items, token usage, cost estimate).
+- Run cross-platform with startup-on-reboot support.
+
+## What It Does
+
+- Interactive job creation flow from natural-language criteria.
+- AI-assisted clarification and job spec generation.
+- Qualification against your prompt for posts (and comments when enabled).
+- Local SQLite persistence for jobs, runs, and scan items.
+- Built-in daemon for scheduled scanning (cron expressions).
+- On-demand CSV export of qualified results per job.
+- Startup registration for macOS, Linux, and Windows.
+- Health checks via the doctor command.
+
+## Install
+
+Requirements:
+- Node.js 20+
+- npm 10+
+
+From npm:
+
+```bash
+npm install -g @telepat/snoopy
+snoopy --help
+```
+
+From source:
+
+```bash
+npm install
+npm run build
+npm link
+```
+
+For first-time onboarding (OpenRouter key setup, first `job add`, and verification), see [Installation & Setup](docs/installation-and-setup.md).
+
+## Development
+
+Run without a global install (contributors):
+
+```bash
+npm run dev -- --help
+```
+
+Core validation commands:
+
+```bash
+npm run lint
+npm run build
+npm test
+```
+
+To refresh coverage locally:
+
+```bash
+npm test -- --coverage
+```
+
+## Releases
+
+Versioning and changelogs are managed automatically by [release-please](https://github.com/googleapis/release-please).
+
+**How it works:**
+1. Merge commits to `main` following [Conventional Commits](https://www.conventionalcommits.org/) (`fix:`, `feat:`, `feat!:`, etc.).
+2. release-please maintains an open "Release PR" that accumulates version bumps and CHANGELOG entries.
+3. Merge the Release PR to cut a release: `package.json` version is bumped, `CHANGELOG.md` is updated, a git tag is created, and the package is published to npm automatically.
+
+**Commit types and semver mapping (while version < 1.0.0):**
+- `fix:` → patch bump
+- `feat:` → patch bump (minor bump is suppressed pre-1.0)
+- `feat!:` or `fix!:` (breaking change) → minor bump (major bump is suppressed pre-1.0)
+
+No manual `git tag` or `npm version` steps are needed.
+
+## Quick Start
+
+Note:
+- Snoopy uses Reddit public JSON endpoints by default.
+- Optional Reddit OAuth fallback credentials can be configured in `snoopy settings` for environments where unauthenticated access is blocked.
+- `snoopy settings` shows a full settings menu so you can jump directly to any setting and save once.
+
+1. Start interactive setup and create your first job:
+
+```bash
+snoopy job add
+```
+
+`job add` now runs an immediate first scan after saving the job so you can validate results right away.
+Snoopy pauses scheduled scans for that new job during this first run attempt, then enables scheduling when it ends (including interruption/failure cases).
+
+2. List jobs:
+
+```bash
+snoopy jobs list
+```
+
+3. Run one job immediately (limit to 5 new items while testing):
+
+```bash
+snoopy job run --limit 5
+snoopy job run <jobRef> --limit 5
+```
+
+If `<jobRef>` is omitted for `job run`, `job enable`, `job disable`, `job delete`, `start`, `stop`, or `errors`, Snoopy shows your job list and lets you pick with up/down arrows and Enter.
+
+4. View run history:
+
+```bash
+snoopy job runs <jobRef>
+```
+
+5. View analytics globally or for one job:
+
+```bash
+snoopy analytics
+snoopy analytics <jobRef>
+snoopy analytics --days 7
+```
+
+6. Regenerate results CSV files (all jobs or one job):
+
+```bash
+snoopy export csv
+snoopy export csv <jobRef>
+```
+
+7. Inspect one run's detailed log output:
+
+```bash
+snoopy logs
+snoopy logs <runId>
+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).
+
+8. Show recent errors for one job:
+
+```bash
+snoopy errors <jobRef>
+```
+
+9. Enable daemon mode:
+
+```bash
+snoopy daemon start
+snoopy daemon reload
+```
+
+## Most Used Commands
+
+- `job add`
+- `job list`
+- `job run [jobRef] --limit <N>`
+- `job runs [jobRef]`
+- `analytics [jobRef] --days <N>`
+- `export csv [jobRef]`
+- `logs [runId]`
+- `errors [jobRef] --hours <N>`
+- `start [jobRef]` / `stop [jobRef]`
+- `delete [jobRef]`
+- `daemon start|stop|status`
+- `daemon reload`
+- `startup status`
+- `doctor`
+
+## Run Logs
+
+- Each job run writes a dedicated log file under `~/.snoopy/logs/`.
+- Files are named `run-<runId>.log`.
+- `snoopy logs` now supports guided selection (job first, then run) and shows a pretty timeline by default with post/comment text snippets, qualification result + justification, and clickable post/comment links.
+- Use `snoopy logs [runId] --raw` to print the full raw log file content, including full JSON request/response payloads for Reddit and OpenRouter calls.
+- Rich TTY manual runs (`snoopy job run <jobRef>`) show compact multi-line scan blocks with indented fields, clickable links, and qualification justifications.
+- In rich terminals, scan field labels are colorized and qualification status is highlighted (`qualified` in green, `not qualified` in red, `pending` in yellow).
+- Run logs older than 5 days are deleted automatically on daemon startup and after each job run.
+- Deleting a job also deletes all associated per-run log files for that job.
+
+## Results CSV Exports
+
+- Export files are generated on demand with `export csv`.
+- Files are written under `~/.snoopy/results/`.
+- Each job gets one file named `<job-slug>.csv`.
+- CSV files are regenerated from database truth on each export command.
+- Deleting a job also deletes that job's CSV file.
+
+## Live E2E Smoke Test
+
+Use the built-in smoke harness to verify create -> run(5) -> delete:
+
+```bash
+npm run e2e:smoke
+```
+
+Optional env vars:
+- `SNOOPY_E2E_LIMIT` (default `5`)
+- `SNOOPY_E2E_SUBREDDITS` (default `startups,entrepreneur`)
+- `SNOOPY_E2E_KEEP_JOB=true` to skip cleanup for debugging
+
+## Full Documentation
+
+- [Documentation Index](docs/README.md)
+- [Installation & Setup](docs/installation-and-setup.md)
+- [Command Reference](docs/commands/index.md)
+- [Database Schema](docs/database-schema.md)
+- [Agent DB Operations](docs/agents-db.md)
+- [Scheduling, Cron, Daemon, and Startup](docs/scheduling-and-startup.md)
+- [Security and Secret Storage](docs/security.md)
+- [E2E Smoke Testing Guide](docs/e2e-testing.md)
+
+## Docs Site
+
+Serve the Docusaurus docs site locally:
+
+```bash
+npm run docs:start
+```
+
+Build and preview the static docs site:
+
+```bash
+npm run docs:build
+npm run docs:serve
+```
+
+Deploy to GitHub Pages:
+
+```bash
+GITHUB_OWNER=telepat-io GITHUB_REPO=snoopy npm run docs:deploy
+```
+
+Docs changes pushed to `main` under `docs/` or `website/` are also rebuilt and published to GitHub Pages automatically via GitHub Actions.

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

@@ -0,0 +1,3 @@
+export declare function showAnalytics(jobRef?: string, options?: {
+    days?: number;
+}): void;

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

@@ -0,0 +1,147 @@
+import { JobsRepository } from '../../services/db/repositories/jobsRepo.js';
+import { AnalyticsService } from '../../services/analytics/analyticsService.js';
+import { printCommandScreen, printError, printInfo, printKeyValue, printMuted, printSection, printWarning } from '../ui/consoleUi.js';
+import { formatRunDisplayTimestamp } from '../ui/time.js';
+function formatInteger(value) {
+    return new Intl.NumberFormat('en-US', { maximumFractionDigits: 0 }).format(value);
+}
+function formatFloat(value, digits = 2) {
+    return new Intl.NumberFormat('en-US', {
+        minimumFractionDigits: digits,
+        maximumFractionDigits: digits
+    }).format(value);
+}
+function formatUsd(value) {
+    return `$${value.toFixed(6)} (est.)`;
+}
+function formatMaybe(value, digits = 2) {
+    if (value === null) {
+        return '-';
+    }
+    return formatFloat(value, digits);
+}
+function printMetricsBlock(metrics) {
+    printKeyValue('New posts scanned', formatInteger(metrics.newPosts));
+    printKeyValue('New comments scanned', formatInteger(metrics.newComments));
+    printKeyValue('Prompt tokens', formatInteger(metrics.promptTokens));
+    printKeyValue('Completion tokens', formatInteger(metrics.completionTokens));
+    printKeyValue('Total tokens', formatInteger(metrics.totalTokens));
+    printKeyValue('Estimated cost', formatUsd(metrics.estimatedCostUsd));
+    printKeyValue('Avg posts/day', formatFloat(metrics.avgNewPostsPerDay));
+    printKeyValue('Avg comments/day', formatFloat(metrics.avgNewCommentsPerDay));
+    printKeyValue('Avg tokens/day', formatFloat(metrics.avgTotalTokensPerDay));
+    printKeyValue('Avg cost/day', formatUsd(metrics.avgEstimatedCostUsdPerDay));
+    printKeyValue('Tokens per post', formatMaybe(metrics.tokensPerPost));
+    printKeyValue('Cost per post', metrics.costPerPost === null ? '-' : formatUsd(metrics.costPerPost));
+}
+function printRunCard(run) {
+    printInfo(`${formatRunDisplayTimestamp(run)} ${run.jobName ?? run.jobId}`);
+    printKeyValue('Run ID', run.id);
+    printKeyValue('Status', run.status);
+    printKeyValue('Duration', run.durationSeconds === null ? '-' : `${run.durationSeconds}s`);
+    printKeyValue('New posts', formatInteger(run.newPosts));
+    printKeyValue('New comments', formatInteger(run.newComments));
+    printKeyValue('Prompt tokens', formatInteger(run.promptTokens));
+    printKeyValue('Completion tokens', formatInteger(run.completionTokens));
+    printKeyValue('Total tokens', formatInteger(run.totalTokens));
+    printKeyValue('Estimated cost', run.estimatedCostUsd === null ? '-' : formatUsd(run.estimatedCostUsd));
+    printKeyValue('Tokens per post', formatMaybe(run.tokensPerPost));
+    printKeyValue('Cost per post', run.costPerPost === null ? '-' : formatUsd(run.costPerPost));
+    printKeyValue('Log', run.logFilePath ?? '-');
+    if (run.message) {
+        printWarning(`Message: ${run.message}`);
+    }
+}
+export function showAnalytics(jobRef, options = {}) {
+    const days = options.days ?? 30;
+    const jobsRepo = new JobsRepository();
+    const analyticsService = new AnalyticsService();
+    printCommandScreen('Analytics');
+    if (jobRef) {
+        const job = jobsRepo.getByRef(jobRef);
+        if (!job) {
+            printError(`Job not found: ${jobRef}`);
+            return;
+        }
+        const view = analyticsService.getJobAnalytics(job.id, { days });
+        printSection(`Job Analytics: ${job.name} (${job.slug})`);
+        printKeyValue('Window', `Last ${view.windowDays} day(s)`);
+        printKeyValue('Runs in window', formatInteger(view.runCount));
+        printMetricsBlock(view.totals);
+        printSection('Subreddit Breakdown');
+        if (view.bySubreddit.length === 0) {
+            printWarning('No subreddit analytics yet for this job in the selected window.');
+        }
+        else {
+            view.bySubreddit.forEach((row) => {
+                printInfo(`r/${row.subreddit}`);
+                printKeyValue('New posts/comments', `${formatInteger(row.newPosts)}/${formatInteger(row.newComments)}`);
+                printKeyValue('Total tokens', formatInteger(row.metrics.totalTokens));
+                printKeyValue('Estimated cost', formatUsd(row.metrics.estimatedCostUsd));
+                printKeyValue('Avg posts/comments per day', `${formatFloat(row.metrics.avgNewPostsPerDay)}/${formatFloat(row.metrics.avgNewCommentsPerDay)}`);
+                printKeyValue('Avg tokens/day', formatFloat(row.metrics.avgTotalTokensPerDay));
+                printKeyValue('Avg cost/day', formatUsd(row.metrics.avgEstimatedCostUsdPerDay));
+            });
+        }
+        printSection('Recent Runs');
+        if (view.recentRuns.length === 0) {
+            printWarning('No runs found in the selected window.');
+            return;
+        }
+        view.recentRuns.forEach((run, index) => {
+            printRunCard(run);
+            if (index < view.recentRuns.length - 1) {
+                printMuted('');
+            }
+        });
+        return;
+    }
+    const view = analyticsService.getGlobalAnalytics({ days });
+    printSection('System Analytics');
+    printKeyValue('Window', `Last ${view.windowDays} day(s)`);
+    printKeyValue('Runs in window', formatInteger(view.runCount));
+    printMetricsBlock(view.totals);
+    printSection('Job Breakdown');
+    if (view.byJob.length === 0) {
+        printWarning('No job analytics yet in the selected window.');
+    }
+    else {
+        view.byJob.forEach((row) => {
+            printInfo(`${row.jobName} (${row.jobSlug})`);
+            printKeyValue('Job ID', row.jobId);
+            printKeyValue('New posts/comments', `${formatInteger(row.newPosts)}/${formatInteger(row.newComments)}`);
+            printKeyValue('Total tokens', formatInteger(row.metrics.totalTokens));
+            printKeyValue('Estimated cost', formatUsd(row.metrics.estimatedCostUsd));
+            printKeyValue('Avg posts/comments per day', `${formatFloat(row.metrics.avgNewPostsPerDay)}/${formatFloat(row.metrics.avgNewCommentsPerDay)}`);
+            printKeyValue('Avg tokens/day', formatFloat(row.metrics.avgTotalTokensPerDay));
+            printKeyValue('Avg cost/day', formatUsd(row.metrics.avgEstimatedCostUsdPerDay));
+        });
+    }
+    printSection('Subreddit Breakdown');
+    if (view.bySubreddit.length === 0) {
+        printWarning('No subreddit analytics yet in the selected window.');
+    }
+    else {
+        view.bySubreddit.forEach((row) => {
+            printInfo(`r/${row.subreddit}`);
+            printKeyValue('New posts/comments', `${formatInteger(row.newPosts)}/${formatInteger(row.newComments)}`);
+            printKeyValue('Total tokens', formatInteger(row.metrics.totalTokens));
+            printKeyValue('Estimated cost', formatUsd(row.metrics.estimatedCostUsd));
+            printKeyValue('Avg posts/comments per day', `${formatFloat(row.metrics.avgNewPostsPerDay)}/${formatFloat(row.metrics.avgNewCommentsPerDay)}`);
+            printKeyValue('Avg tokens/day', formatFloat(row.metrics.avgTotalTokensPerDay));
+            printKeyValue('Avg cost/day', formatUsd(row.metrics.avgEstimatedCostUsdPerDay));
+        });
+    }
+    printSection('Recent Runs');
+    if (view.recentRuns.length === 0) {
+        printWarning('No runs found in the selected window.');
+        return;
+    }
+    view.recentRuns.forEach((run, index) => {
+        printRunCard(run);
+        if (index < view.recentRuns.length - 1) {
+            printMuted('');
+        }
+    });
+}
+//# sourceMappingURL=analytics.js.map

package/dist/src/cli/commands/analytics.js.map

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

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

@@ -0,0 +1,5 @@
+export declare function daemonRun(): void;
+export declare function daemonReload(): void;
+export declare function daemonStart(): void;
+export declare function daemonStop(): void;
+export declare function daemonStatus(): void;

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

@@ -0,0 +1,85 @@
+import fs from 'node:fs';
+import { CronScheduler } from '../../services/scheduler/cronScheduler.js';
+import { cleanupOldLogs } from '../../services/logging/logRotation.js';
+import { ensureAppDirs } from '../../utils/paths.js';
+import { ensureDaemonRunning, isDaemonRunning, requestDaemonReload } from '../../services/daemonControl.js';
+import { printCommandScreen, printError, printInfo, printMuted, printSuccess, printWarning } from '../ui/consoleUi.js';
+let scheduler = null;
+export function daemonRun() {
+    ensureAppDirs();
+    cleanupOldLogs();
+    printCommandScreen('Daemon mode', 'Daemon');
+    scheduler = new CronScheduler();
+    scheduler.start();
+    process.on('SIGTERM', () => {
+        scheduler?.stop();
+        process.exit(0);
+    });
+    process.on('SIGINT', () => {
+        scheduler?.stop();
+        process.exit(0);
+    });
+    process.on('SIGUSR2', () => {
+        scheduler?.reload();
+    });
+    setInterval(() => {
+        // Keep event loop alive for cron tasks.
+    }, 60_000);
+    printSuccess('Snoopy daemon is running.');
+    printMuted('Press Ctrl+C to stop.');
+}
+export function daemonReload() {
+    printCommandScreen('Daemon control', 'Daemon Reload');
+    const result = requestDaemonReload();
+    if (!result.pid) {
+        printWarning('Daemon is not running.');
+        return;
+    }
+    if (!result.reloaded) {
+        printError(`Could not reload daemon schedules for pid ${result.pid}.`);
+        printMuted('If this persists, restart the daemon with snoopy daemon stop && snoopy daemon start.');
+        return;
+    }
+    printSuccess(`Reloaded daemon schedules (pid ${result.pid}).`);
+}
+export function daemonStart() {
+    printCommandScreen('Daemon control', 'Daemon Start');
+    const status = ensureDaemonRunning();
+    if (!status.started) {
+        printWarning(`Daemon already running${status.pid ? ` (pid ${status.pid})` : ''}.`);
+        return;
+    }
+    printSuccess(`Daemon started (pid ${status.pid}).`);
+}
+export function daemonStop() {
+    printCommandScreen('Daemon control', 'Daemon Stop');
+    const paths = ensureAppDirs();
+    if (!fs.existsSync(paths.pidFilePath)) {
+        printWarning('Daemon is not running.');
+        return;
+    }
+    const pid = Number(fs.readFileSync(paths.pidFilePath, 'utf8'));
+    try {
+        process.kill(pid, 'SIGTERM');
+    }
+    catch {
+        // Ignore if already dead.
+    }
+    fs.unlinkSync(paths.pidFilePath);
+    printSuccess('Daemon stopped.');
+}
+export function daemonStatus() {
+    printCommandScreen('Daemon control', 'Daemon Status');
+    const status = isDaemonRunning();
+    if (!status.pid) {
+        printInfo('Daemon status: stopped');
+        return;
+    }
+    if (status.running) {
+        printSuccess(`Daemon status: running (pid ${status.pid})`);
+        return;
+    }
+    printError(`Daemon status: stale pid file (pid ${status.pid})`);
+    printMuted('Run snoopy daemon stop to clear stale state.');
+}
+//# sourceMappingURL=daemon.js.map

package/dist/src/cli/commands/daemon.js.map

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

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

@@ -0,0 +1 @@
+export declare function runDoctor(): Promise<void>;

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

@@ -0,0 +1,106 @@
+import fs from 'node:fs';
+import { getDb } from '../../services/db/sqlite.js';
+import { JobsRepository } from '../../services/db/repositories/jobsRepo.js';
+import { RunsRepository } from '../../services/db/repositories/runsRepo.js';
+import { extractErrorEntries, readRunLog } from '../../services/logging/logReader.js';
+import { getOpenRouterApiKey } from '../../services/security/secretStore.js';
+import { getStartupStatus } from '../../services/startup/index.js';
+import { ensureAppDirs } from '../../utils/paths.js';
+import { printCommandScreen, printError, printInfo, printKeyValue, printSection, printSuccess, printWarning } from '../ui/consoleUi.js';
+import { formatRunDisplayTimestamp } from '../ui/time.js';
+function getDaemonHealth() {
+    const paths = ensureAppDirs();
+    if (!fs.existsSync(paths.pidFilePath)) {
+        return { ok: false, details: 'Daemon not running (no pid file)' };
+    }
+    const pid = Number(fs.readFileSync(paths.pidFilePath, 'utf8'));
+    if (!Number.isFinite(pid)) {
+        return { ok: false, details: 'Invalid daemon pid file' };
+    }
+    try {
+        process.kill(pid, 0);
+        return { ok: true, details: `Daemon running (pid ${pid})` };
+    }
+    catch {
+        return { ok: false, details: `Stale daemon pid file (pid ${pid})` };
+    }
+}
+function isWithinLast24Hours(createdAt) {
+    const timestamp = Date.parse(createdAt);
+    if (Number.isNaN(timestamp)) {
+        return false;
+    }
+    return timestamp >= Date.now() - 24 * 60 * 60 * 1000;
+}
+export async function runDoctor() {
+    printCommandScreen('Diagnostics', 'Snoopy Doctor');
+    const paths = ensureAppDirs();
+    let dbOk = false;
+    let dbDetails = `DB file: ${paths.dbPath}`;
+    try {
+        const db = getDb();
+        db.prepare('SELECT 1').get();
+        dbOk = true;
+        dbDetails = `DB reachable at ${paths.dbPath}`;
+    }
+    catch (error) {
+        dbDetails = `DB error: ${String(error)}`;
+    }
+    const jobsRepo = new JobsRepository();
+    const runsRepo = new RunsRepository();
+    const jobs = jobsRepo.list();
+    const enabledJobs = jobs.filter((job) => job.enabled).length;
+    const apiKey = await getOpenRouterApiKey();
+    const startup = getStartupStatus();
+    const daemon = getDaemonHealth();
+    printKeyValue('Platform', process.platform);
+    printKeyValue('Node', process.version);
+    if (dbOk) {
+        printSuccess(`Database: ${dbDetails}`);
+    }
+    else {
+        printError(`Database: ${dbDetails}`);
+    }
+    if (apiKey) {
+        printSuccess('OpenRouter API key: configured');
+    }
+    else {
+        printWarning('OpenRouter API key: missing');
+    }
+    printInfo(`Jobs: ${jobs.length} total, ${enabledJobs} enabled`);
+    if (daemon.ok) {
+        printSuccess(`Daemon: ${daemon.details}`);
+    }
+    else {
+        printWarning(`Daemon: ${daemon.details}`);
+    }
+    printInfo(`Startup on reboot: ${startup.enabled ? 'enabled' : 'disabled'} via ${startup.method}`);
+    printInfo(`Startup details: ${startup.detail}`);
+    printSection('Recent Job Errors');
+    const recentProblemRuns = runsRepo
+        .latestWithJobNames(20)
+        .filter((run) => isWithinLast24Hours(run.createdAt))
+        .map((run) => {
+        const logContent = readRunLog(run.logFilePath);
+        const errorEntries = extractErrorEntries(logContent ?? '');
+        return {
+            run,
+            errorEntries
+        };
+    })
+        .filter(({ run, errorEntries }) => run.status === 'failed' || errorEntries.length > 0);
+    if (recentProblemRuns.length === 0) {
+        printSuccess('No recent job run failures or logged errors in the last 24 hours.');
+        return;
+    }
+    printWarning(`Found ${recentProblemRuns.length} recent run(s) with failures or logged errors.`);
+    recentProblemRuns.forEach(({ run, errorEntries }) => {
+        printWarning(`${formatRunDisplayTimestamp(run)} ${run.jobName ?? run.jobId} (${run.status})`);
+        printKeyValue('Run ID', run.id);
+        printKeyValue('Message', run.message ?? '-');
+        if (errorEntries.length > 0) {
+            printInfo(errorEntries[errorEntries.length - 1].split('\n')[0]);
+        }
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/src/cli/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE1D,SAAS,eAAe;IACtB,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,uBAAuB,GAAG,GAAG,EAAE,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,8BAA8B,GAAG,GAAG,EAAE,CAAC;IACtE,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,SAAiB;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,kBAAkB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAE9B,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,SAAS,GAAG,YAAY,KAAK,CAAC,MAAM,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,GAAG,IAAI,CAAC;QACZ,SAAS,GAAG,mBAAmB,KAAK,CAAC,MAAM,EAAE,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,SAAS,GAAG,aAAa,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAE7D,MAAM,MAAM,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IAEjC,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC,IAAI,IAAI,EAAE,CAAC;QACT,YAAY,CAAC,aAAa,SAAS,EAAE,CAAC,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,aAAa,SAAS,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,YAAY,CAAC,gCAAgC,CAAC,CAAC;IACjD,CAAC;SAAM,CAAC;QACN,YAAY,CAAC,6BAA6B,CAAC,CAAC;IAC9C,CAAC;IAED,SAAS,CAAC,SAAS,IAAI,CAAC,MAAM,WAAW,WAAW,UAAU,CAAC,CAAC;IAEhE,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,YAAY,CAAC,WAAW,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;SAAM,CAAC;QACN,YAAY,CAAC,WAAW,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,SAAS,CAAC,sBAAsB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAClG,SAAS,CAAC,oBAAoB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEhD,YAAY,CAAC,mBAAmB,CAAC,CAAC;IAClC,MAAM,iBAAiB,GAAG,QAAQ;SAC/B,kBAAkB,CAAC,EAAE,CAAC;SACtB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;SACnD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,YAAY,GAAG,mBAAmB,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAC3D,OAAO;YACL,GAAG;YACH,YAAY;SACb,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEzF,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,YAAY,CAAC,mEAAmE,CAAC,CAAC;QAClF,OAAO;IACT,CAAC;IAED,YAAY,CAAC,SAAS,iBAAiB,CAAC,MAAM,gDAAgD,CAAC,CAAC;IAChG,iBAAiB,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE;QAClD,YAAY,CAAC,GAAG,yBAAyB,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9F,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,aAAa,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC;QAC7C,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,3 @@
+export declare function showJobErrors(jobRef?: string, options?: {
+    hours?: number;
+}): Promise<void>;