hn-bits 0.4.0 → 0.5.0

package/README.md

@@ -107,7 +107,15 @@ All three keys are required, `telegram.enabled` alone is not enough. With nothin
 hn watch --once   # one pass: query subscriptions, notify new matches, exit
 ```
 
-Schedule it, e.g. every 30 minutes via crontab:
+The first `hn sub add` offers to install a cron job for you (every 30 minutes). Manage it anytime via the CLI, or `c` on the Subs tab (which also shows a live installed/not-installed status line):
+
+```bash
+hn schedule status   # installed / not installed
+hn schedule install  # install now (no-op if already installed)
+hn schedule remove   # uninstall
+```
+
+Or set it up by hand:
 
 ```
 */30 * * * * cd /path/to/hn-bits && hn watch --once
@@ -188,6 +196,9 @@ Same as story list, minus search; `B` removes a bookmark instead of adding one.
 | `a` | add subscription |
 | `e` | edit subscription |
 | `d` | delete subscription |
+| `c` | toggle watch cron schedule (install/remove) |
+
+Shows a `schedule: installed (every 30 min)` / `schedule: not installed` status line, so you don't need to drop to `hn schedule status` to check.
 
 **Sub matches** (opened from Subs via `enter`)
 

package/dist/index.js

@@ -112,6 +112,24 @@ config
     }
 });
 const sub = program.command('sub').description('Manage topic subscriptions');
+async function promptInstallSchedule() {
+    const readline = await import('node:readline/promises');
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await rl.question('No watch schedule installed yet. Install one now (every 30 min)? [y/N] ');
+    rl.close();
+    if (!/^y(es)?$/i.test(answer.trim())) {
+        console.log("skipped. Run 'hn schedule install' anytime, or add the cron line yourself (see README).");
+        return;
+    }
+    const { installScheduledJob } = await import('./lib/schedule.js');
+    try {
+        const line = installScheduledJob();
+        console.log(`installed: ${line}`);
+    }
+    catch {
+        console.log("couldn't find 'hn' on PATH — add the cron line yourself (see README) or run 'hn schedule install' later.");
+    }
+}
 sub
     .command('add <name> <query...>')
     .description('Add a subscription')
@@ -122,7 +140,7 @@ sub
         console.error(`--min-points must be a non-negative integer, got '${options.minPoints}'`);
         process.exit(1);
     }
-    const { addSubscription } = await import('./db/subscriptions.js');
+    const { addSubscription, listSubscriptions } = await import('./db/subscriptions.js');
     try {
         addSubscription(name, queryParts.join(' '), minPoints);
         console.log(`added '${name}'`);
@@ -131,6 +149,10 @@ sub
         console.error(err.message);
         process.exit(1);
     }
+    const { hasScheduledJob } = await import('./lib/schedule.js');
+    if (listSubscriptions().length === 1 && !hasScheduledJob()) {
+        await promptInstallSchedule();
+    }
 });
 sub
     .command('list')
@@ -161,6 +183,34 @@ sub
     }
     console.log(`removed '${name}'`);
 });
+const schedule = program.command('schedule').description('Manage the cron job that runs `hn watch --once`');
+schedule
+    .command('status')
+    .description('Show whether the watch cron job is installed')
+    .action(async () => {
+    const { hasScheduledJob } = await import('./lib/schedule.js');
+    console.log(hasScheduledJob() ? 'installed' : 'not installed');
+});
+schedule
+    .command('install')
+    .description('Install the watch cron job (no-op if already installed)')
+    .action(async () => {
+    const { installScheduledJob } = await import('./lib/schedule.js');
+    try {
+        console.log(`installed: ${installScheduledJob()}`);
+    }
+    catch {
+        console.error("couldn't find 'hn' on PATH; add the cron line yourself (see README)");
+        process.exit(1);
+    }
+});
+schedule
+    .command('remove')
+    .description('Remove the watch cron job')
+    .action(async () => {
+    const { removeScheduledJob } = await import('./lib/schedule.js');
+    console.log(removeScheduledJob() ? 'removed' : 'not installed');
+});
 program
     .command('watch')
     .description('Check subscriptions for new matches and notify (one-shot; cron owns scheduling)')

package/dist/lib/schedule.js

@@ -0,0 +1,53 @@
+import { execSync } from 'node:child_process';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const MARKER = '# hn-bits watch';
+function watchLogPath() {
+    return join(homedir(), '.local', 'share', 'hn-bits', 'watch.log');
+}
+function readCrontab() {
+    try {
+        return execSync('crontab -l', { encoding: 'utf-8' });
+    }
+    catch {
+        return '';
+    }
+}
+function writeCrontab(content) {
+    execSync('crontab -', { input: content, encoding: 'utf-8' });
+}
+function resolveHnPath() {
+    return execSync('which hn', { encoding: 'utf-8' }).trim();
+}
+function resolveNodePath() {
+    return execSync('which node', { encoding: 'utf-8' }).trim();
+}
+/** Invokes node directly rather than relying on hn's `#!/usr/bin/env node` shebang, since cron's
+ * minimal PATH (unlike an interactive shell) usually can't resolve a version-manager-installed node. */
+function buildCronLine(nodePath, hnPath) {
+    return `*/30 * * * * ${nodePath} ${hnPath} watch --once >> ${watchLogPath()} 2>&1 ${MARKER}`;
+}
+export function hasScheduledJob() {
+    return readCrontab()
+        .split('\n')
+        .some((line) => line.includes(MARKER));
+}
+/** Idempotent: no-ops if a job is already installed. Throws if `hn` isn't on PATH. */
+export function installScheduledJob() {
+    const current = readCrontab();
+    const existing = current.split('\n').find((line) => line.includes(MARKER));
+    if (existing)
+        return existing;
+    const line = buildCronLine(resolveNodePath(), resolveHnPath());
+    const body = current.trim().length > 0 ? `${current.replace(/\n+$/, '')}\n${line}\n` : `${line}\n`;
+    writeCrontab(body);
+    return line;
+}
+export function removeScheduledJob() {
+    const lines = readCrontab().split('\n');
+    const filtered = lines.filter((line) => !line.includes(MARKER));
+    if (filtered.length === lines.length)
+        return false;
+    writeCrontab(filtered.join('\n'));
+    return true;
+}

package/dist/ui/SubscriptionForm.js

@@ -2,8 +2,9 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from 'react';
 import { Box, Text, useInput, useWindowSize } from 'ink';
 import { searchRecent } from '../api/algolia.js';
-import { addSubscription, updateSubscription } from '../db/subscriptions.js';
+import { addSubscription, listSubscriptions, updateSubscription } from '../db/subscriptions.js';
 import { truncateTitle } from '../lib/format.js';
+import { hasScheduledJob, installScheduledJob } from '../lib/schedule.js';
 import { useTheme } from './theme.js';
 const PREVIEW_DEBOUNCE_MS = 300;
 const PREVIEW_WINDOW_DAYS = 7;
@@ -21,6 +22,7 @@ export function SubscriptionForm({ mode, subscription, prefillQuery, onSave, onC
     const [field, setField] = useState('name');
     const [error, setError] = useState('');
     const [preview, setPreview] = useState([]);
+    const [scheduleConfirm, setScheduleConfirm] = useState(false);
     const debounceRef = useRef(null);
     const previewToken = useRef(0);
     useEffect(() => {
@@ -63,13 +65,36 @@ export function SubscriptionForm({ mode, subscription, prefillQuery, onSave, onC
                 addSubscription(trimmedName, trimmedQuery, points);
             else
                 updateSubscription(subscription.id, { name: trimmedName, query: trimmedQuery, minPoints: points });
+            if (mode === 'add' && listSubscriptions().length === 1 && !hasScheduledJob()) {
+                setScheduleConfirm(true);
+                return;
+            }
             onSave();
         }
         catch (err) {
             setError(err.message);
         }
     }
+    function resolveScheduleConfirm(install) {
+        if (install) {
+            try {
+                installScheduledJob();
+            }
+            catch {
+                // hn not on PATH; user can run `hn schedule install` later
+            }
+        }
+        setScheduleConfirm(false);
+        onSave();
+    }
     function handleInput(input, key) {
+        if (scheduleConfirm) {
+            if (input === 'y')
+                return resolveScheduleConfirm(true);
+            if (input === 'n' || key.escape)
+                return resolveScheduleConfirm(false);
+            return;
+        }
         if (key.escape)
             return onCancel();
         if (key.tab) {
@@ -100,5 +125,5 @@ export function SubscriptionForm({ mode, subscription, prefillQuery, onSave, onC
     useInput(handleInput);
     const cursor = (f) => (field === f ? '▏' : '');
     const previewLabel = Number(minPoints) > 0 ? `≥${minPoints} pts` : 'any points';
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.colors.title, children: mode === 'add' ? 'New subscription' : 'Edit subscription' }), _jsx(Text, { children: " " }), _jsxs(Text, { children: ["name:        ", name, cursor('name')] }), _jsxs(Text, { children: ["query:       ", query, cursor('query')] }), _jsxs(Text, { children: ["min points:  ", minPoints, cursor('minPoints')] }), _jsx(Text, { children: " " }), query.trim() && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["preview (last 7 days, ", previewLabel, "):"] }), preview.length === 0 && _jsx(Text, { dimColor: true, children: " no matches" }), preview.map((story, i) => (_jsxs(Text, { children: [' ', i + 1, ". ", truncateTitle(story.title, Math.max(1, columns - 24)), "  ", story.score, " pts"] }, story.id)))] })), error && _jsx(Text, { color: theme.colors.error, children: error }), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "tab next field \u00B7 enter save \u00B7 esc cancel" })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.colors.title, children: mode === 'add' ? 'New subscription' : 'Edit subscription' }), _jsx(Text, { children: " " }), _jsxs(Text, { children: ["name:        ", name, cursor('name')] }), _jsxs(Text, { children: ["query:       ", query, cursor('query')] }), _jsxs(Text, { children: ["min points:  ", minPoints, cursor('minPoints')] }), _jsx(Text, { children: " " }), query.trim() && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["preview (last 7 days, ", previewLabel, "):"] }), preview.length === 0 && _jsx(Text, { dimColor: true, children: " no matches" }), preview.map((story, i) => (_jsxs(Text, { children: [' ', i + 1, ". ", truncateTitle(story.title, Math.max(1, columns - 24)), "  ", story.score, " pts"] }, story.id)))] })), error && _jsx(Text, { color: theme.colors.error, children: error }), _jsx(Text, { children: " " }), scheduleConfirm ? (_jsx(Text, { dimColor: true, children: "no watch schedule installed yet - install one now (every 30 min)? y/n" })) : (_jsx(Text, { dimColor: true, children: "tab next field \u00B7 enter save \u00B7 esc cancel" }))] }));
 }

package/dist/ui/SubscriptionsView.js

@@ -4,10 +4,12 @@ import { Box, Text, useInput, useWindowSize } from 'ink';
 import { listSubscriptions, removeSubscription } from '../db/subscriptions.js';
 import { formatAge } from '../lib/format.js';
 import { clampSelection, mapFeedKey } from '../lib/listNavigation.js';
+import { hasScheduledJob, installScheduledJob, removeScheduledJob } from '../lib/schedule.js';
 import { ensureVisibleLines, sliceByLines } from '../lib/viewport.js';
 import { footerRows, SUBS_KEYS } from './keymap.js';
 import { HEADER_ROWS } from './Layout.js';
 import { useTheme } from './theme.js';
+import { useFlash } from './useFlash.js';
 function pointsLabel(minPoints) {
     return minPoints === 0 ? 'any' : `≥${minPoints} pts`;
 }
@@ -18,6 +20,8 @@ export function SubscriptionsView({ onSelectMatches, onAdd, onEdit, onFeedChange
     const [subs, setSubs] = useState(() => listSubscriptions());
     const [selected, setSelected] = useState(0);
     const [deleteConfirm, setDeleteConfirm] = useState(null);
+    const [scheduleInstalled, setScheduleInstalled] = useState(() => hasScheduledJob());
+    const [scheduleFlash, flashSchedule] = useFlash();
     const pendingTopJump = useRef(false);
     const topLineRef = useRef(0);
     function reload() {
@@ -25,6 +29,22 @@ export function SubscriptionsView({ onSelectMatches, onAdd, onEdit, onFeedChange
         setSubs(next);
         setSelected((s) => clampSelection(s, 0, next.length));
     }
+    function toggleSchedule() {
+        if (scheduleInstalled) {
+            removeScheduledJob();
+            setScheduleInstalled(false);
+            flashSchedule('schedule removed');
+            return;
+        }
+        try {
+            installScheduledJob();
+            setScheduleInstalled(true);
+            flashSchedule('schedule installed');
+        }
+        catch {
+            flashSchedule("couldn't find 'hn' on PATH");
+        }
+    }
     function handleInput(input, key) {
         if (deleteConfirm) {
             if (input === 'y') {
@@ -61,12 +81,17 @@ export function SubscriptionsView({ onSelectMatches, onAdd, onEdit, onFeedChange
             return onEdit(subs[selected]);
         if (input === 'd' && subs[selected])
             return setDeleteConfirm(subs[selected].name);
+        if (input === 'c')
+            return toggleSchedule();
     }
     useInput(handleInput);
+    const scheduleStatusText = scheduleInstalled ? 'schedule: installed (every 30 min)' : 'schedule: not installed';
     if (subs.length === 0) {
-        return _jsx(Text, { dimColor: true, children: "no subscriptions yet - press a to add" });
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "no subscriptions yet - press a to add" }), _jsx(Text, { dimColor: true, children: scheduleStatusText }), scheduleFlash && _jsx(Text, { dimColor: true, children: scheduleFlash })] }));
     }
-    const statusLineHeight = deleteConfirm ? 1 : 0;
+    const deleteLineHeight = deleteConfirm ? 1 : 0;
+    const scheduleFlashLineHeight = scheduleFlash ? 1 : 0;
+    const statusLineHeight = 1 + deleteLineHeight + scheduleFlashLineHeight;
     const listHeight = Math.max(1, bodyHeight - statusLineHeight);
     const heights = subs.map(() => 1);
     const topLine = ensureVisibleLines(heights, selected, topLineRef.current, listHeight);
@@ -79,5 +104,5 @@ export function SubscriptionsView({ onSelectMatches, onAdd, onEdit, onFeedChange
                 const marker = isSelected ? theme.glyphs.selection : ' ';
                 const background = isSelected ? theme.colors.selectionBackground : undefined;
                 return (_jsxs(Text, { backgroundColor: background, children: [marker, " ", sub.name.padEnd(nameWidth), "  \"", sub.query, "\"  ", pointsLabel(sub.minPoints).padEnd(9), "  added", ' ', formatAge(sub.createdAt), " ago"] }, sub.id));
-            }), deleteConfirm && _jsxs(Text, { dimColor: true, children: ["delete '", deleteConfirm, "'? y/n"] })] }));
+            }), deleteConfirm && _jsxs(Text, { dimColor: true, children: ["delete '", deleteConfirm, "'? y/n"] }), _jsx(Text, { dimColor: true, children: scheduleStatusText }), scheduleFlash && _jsx(Text, { dimColor: true, children: scheduleFlash })] }));
 }

package/dist/ui/keymap.js

@@ -49,6 +49,7 @@ export const SUBS_KEYS = [
     { key: 'a', label: 'add' },
     { key: 'e', label: 'edit' },
     { key: 'd', label: 'delete' },
+    { key: 'c', label: 'schedule' },
 ];
 export const SUB_MATCHES_KEYS = [
     { key: 'j/k', label: 'move' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hn-bits",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Terminal-first Hacker News client",
   "type": "module",
   "repository": {