@calesennett/pi-hn 0.1.0

package/README.md

@@ -0,0 +1,27 @@
+# pi-hn
+
+A simple Hacker News front-page reader extension for [pi](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent).
+
+![pi-hn screenshot](https://github.com/calesennett/pi-hn/blob/main/assets/pi-hn.png)
+
+## Features
+
+- `/hn` command opens a selectable front-page list
+- Read tracking is stored in a local JSON file at `~/.pi/agent/data/pi-hn/db.json` (or `$PI_CODING_AGENT_DIR/data/pi-hn/db.json`)
+- `j/k` (and arrow keys) navigate the list
+- `a` or `Enter` opens the article URL
+- `c` opens comments in browser
+
+## Install
+
+```bash
+pi install npm:@calesennett/pi-hn
+```
+
+## Local development
+
+In this repo, load the extension directly:
+
+```bash
+pi -e ./extensions/hn.ts
+```

package/extensions/hn.ts

@@ -0,0 +1,482 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { DynamicBorder } from "@mariozechner/pi-coding-agent";
+import { Container, SelectList, Text } from "@mariozechner/pi-tui";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+
+const HN_FRONT_PAGE_API = "https://hn.algolia.com/api/v1/search?tags=front_page&hitsPerPage=30";
+
+interface HNHit {
+	title: string | null;
+	points: number | null;
+	num_comments: number | null;
+	url: string | null;
+	objectID: string;
+}
+
+interface HNRawHit {
+	title?: string | null;
+	points?: number | null;
+	num_comments?: number | null;
+	url?: string | null;
+	objectID?: string | null;
+	objectId?: string | null;
+}
+
+interface HNResponse {
+	hits: HNRawHit[];
+}
+
+interface PersistResult {
+	ok: boolean;
+	error?: string;
+}
+
+interface ReadLookupResult {
+	ok: boolean;
+	readIds: Set<string>;
+	error?: string;
+}
+
+interface StoredArticle {
+	id: number;
+	hn_id: string;
+	title: string | null;
+	url: string | null;
+	read_at: number | null;
+	first_seen_at: number;
+	last_seen_at: number;
+	created_at: number;
+	updated_at: number;
+}
+
+interface ArticleStore {
+	next_id: number;
+	articles: StoredArticle[];
+}
+
+function getPiAgentDir(): string {
+	const configured = process.env.PI_CODING_AGENT_DIR?.trim();
+	if (configured && configured.length > 0) return configured;
+	return join(homedir(), ".pi", "agent");
+}
+
+const HN_STORE_PATH = join(getPiAgentDir(), "data", "pi-hn", "db.json");
+let isStoreInitialized = false;
+let storeInitError: string | null = null;
+
+function nowUnix(): number {
+	return Math.floor(Date.now() / 1000);
+}
+
+function emptyStore(): ArticleStore {
+	return {
+		next_id: 1,
+		articles: [],
+	};
+}
+
+function getErrorMessage(error: unknown): string {
+	if (error instanceof Error && error.message) return error.message;
+	return "Unknown error";
+}
+
+function readStore(): ArticleStore {
+	if (!existsSync(HN_STORE_PATH)) {
+		return emptyStore();
+	}
+
+	const raw = readFileSync(HN_STORE_PATH, "utf8").trim();
+	if (raw.length === 0) return emptyStore();
+
+	const parsed = JSON.parse(raw) as Partial<ArticleStore>;
+	if (!Array.isArray(parsed.articles) || typeof parsed.next_id !== "number") {
+		throw new Error("Invalid JSON store format");
+	}
+
+	return {
+		next_id: parsed.next_id,
+		articles: parsed.articles,
+	};
+}
+
+function writeStore(store: ArticleStore): void {
+	mkdirSync(dirname(HN_STORE_PATH), { recursive: true });
+	const tmpPath = `${HN_STORE_PATH}.tmp`;
+	writeFileSync(tmpPath, `${JSON.stringify(store, null, 2)}\n`, "utf8");
+	renameSync(tmpPath, HN_STORE_PATH);
+}
+
+function ensureStore(): PersistResult {
+	if (isStoreInitialized) return { ok: true };
+
+	try {
+		mkdirSync(dirname(HN_STORE_PATH), { recursive: true });
+		if (!existsSync(HN_STORE_PATH)) {
+			writeStore(emptyStore());
+		} else {
+			void readStore();
+		}
+		isStoreInitialized = true;
+		storeInitError = null;
+		return { ok: true };
+	} catch (error) {
+		storeInitError = getErrorMessage(error);
+		return { ok: false, error: storeInitError };
+	}
+}
+
+function persistFetchedArticles(hits: HNHit[]): PersistResult {
+	if (hits.length === 0) return { ok: true };
+
+	const ready = ensureStore();
+	if (!ready.ok) return ready;
+
+	try {
+		const store = readStore();
+		const now = nowUnix();
+		const existingByHnId = new Map(store.articles.map((article) => [article.hn_id, article]));
+
+		for (const hit of hits) {
+			const existing = existingByHnId.get(hit.objectID);
+			if (existing) {
+				existing.title = hit.title ?? null;
+				existing.url = hit.url ?? null;
+				existing.last_seen_at = now;
+				existing.updated_at = now;
+				continue;
+			}
+
+			store.articles.push({
+				id: store.next_id,
+				hn_id: hit.objectID,
+				title: hit.title ?? null,
+				url: hit.url ?? null,
+				read_at: null,
+				first_seen_at: now,
+				last_seen_at: now,
+				created_at: now,
+				updated_at: now,
+			});
+			store.next_id += 1;
+		}
+
+		writeStore(store);
+		return { ok: true };
+	} catch (error) {
+		return { ok: false, error: getErrorMessage(error) };
+	}
+}
+
+function persistReadArticles(hits: HNHit[]): PersistResult {
+	if (hits.length === 0) return { ok: true };
+
+	const ready = ensureStore();
+	if (!ready.ok) return ready;
+
+	try {
+		const store = readStore();
+		const now = nowUnix();
+		const existingByHnId = new Map(store.articles.map((article) => [article.hn_id, article]));
+
+		for (const hit of hits) {
+			const existing = existingByHnId.get(hit.objectID);
+			if (existing) {
+				existing.title = hit.title ?? null;
+				existing.url = hit.url ?? null;
+				existing.read_at = existing.read_at ?? now;
+				existing.last_seen_at = now;
+				existing.updated_at = now;
+				continue;
+			}
+
+			store.articles.push({
+				id: store.next_id,
+				hn_id: hit.objectID,
+				title: hit.title ?? null,
+				url: hit.url ?? null,
+				read_at: now,
+				first_seen_at: now,
+				last_seen_at: now,
+				created_at: now,
+				updated_at: now,
+			});
+			store.next_id += 1;
+		}
+
+		writeStore(store);
+		return { ok: true };
+	} catch (error) {
+		return { ok: false, error: getErrorMessage(error) };
+	}
+}
+
+function loadReadArticleIds(hits: HNHit[]): ReadLookupResult {
+	if (hits.length === 0) return { ok: true, readIds: new Set<string>() };
+
+	const ready = ensureStore();
+	if (!ready.ok) return { ok: false, readIds: new Set<string>(), error: ready.error };
+
+	try {
+		const store = readStore();
+		const currentHitIds = new Set(hits.map((hit) => hit.objectID));
+		const readIds = new Set(
+			store.articles
+				.filter((article) => article.read_at !== null && currentHitIds.has(article.hn_id))
+				.map((article) => article.hn_id),
+		);
+		return { ok: true, readIds };
+	} catch (error) {
+		return { ok: false, readIds: new Set<string>(), error: getErrorMessage(error) };
+	}
+}
+
+function normalizeTitle(title: string | null | undefined): string {
+	const normalized = (title ?? "").replace(/\s+/g, " ").trim();
+	return normalized.length > 0 ? normalized : "(untitled)";
+}
+
+function formatListLabel(hit: HNHit, isRead: boolean): string {
+	const points = typeof hit.points === "number" ? hit.points : 0;
+	const comments = typeof hit.num_comments === "number" ? hit.num_comments : 0;
+	const marker = isRead ? "✓ " : "  ";
+	return `${marker}${normalizeTitle(hit.title)} (${points} points, ${comments} comments)`;
+}
+
+function commentsUrl(hit: HNHit): string {
+	return `https://news.ycombinator.com/item?id=${encodeURIComponent(hit.objectID)}`;
+}
+
+async function openInBrowser(pi: ExtensionAPI, url: string): Promise<{ ok: boolean; error?: string }> {
+	const windowsQuotedUrl = `"${url.replace(/"/g, '""')}"`;
+	const result =
+		process.platform === "darwin"
+			? await pi.exec("open", [url])
+			: process.platform === "win32"
+				? await pi.exec("cmd", ["/c", "start", "", windowsQuotedUrl])
+				: await pi.exec("xdg-open", [url]);
+
+	if (result.code !== 0) {
+		return {
+			ok: false,
+			error: result.stderr.trim() || `Failed to open URL (exit code ${result.code})`,
+		};
+	}
+
+	return { ok: true };
+}
+
+async function fetchFrontPage(): Promise<HNHit[]> {
+	const response = await fetch(HN_FRONT_PAGE_API);
+	if (!response.ok) {
+		throw new Error(`Hacker News API returned ${response.status}`);
+	}
+
+	const data = (await response.json()) as Partial<HNResponse>;
+	if (!Array.isArray(data.hits)) return [];
+
+	return data.hits
+		.map((hit) => {
+			const objectID = hit.objectID ?? hit.objectId;
+			if (!objectID) return undefined;
+			return {
+				title: hit.title ?? null,
+				points: hit.points ?? 0,
+				num_comments: hit.num_comments ?? 0,
+				url: hit.url ?? null,
+				objectID,
+			} as HNHit;
+		})
+		.filter((hit): hit is HNHit => Boolean(hit))
+		.sort((a, b) => {
+			const pointsDiff = (b.points ?? 0) - (a.points ?? 0);
+			if (pointsDiff !== 0) return pointsDiff;
+
+			return (b.num_comments ?? 0) - (a.num_comments ?? 0);
+		});
+}
+
+export default function hackerNewsExtension(pi: ExtensionAPI) {
+	pi.registerCommand("hn", {
+		description: "Browse Hacker News front page in a list (a=article, c=comments)",
+		handler: async (_args, ctx) => {
+			if (!ctx.hasUI) return;
+
+			let hits: HNHit[];
+			try {
+				hits = await fetchFrontPage();
+			} catch (error) {
+				const message = error instanceof Error ? error.message : "Unknown error";
+				ctx.ui.notify(`Failed to load Hacker News front page: ${message}`, "error");
+				return;
+			}
+
+			if (hits.length === 0) {
+				ctx.ui.notify("Hacker News front page returned no items.", "warning");
+				return;
+			}
+
+			const persistedFetches = persistFetchedArticles(hits);
+			if (!persistedFetches.ok) {
+				ctx.ui.notify(
+					`Could not persist fetched articles to ${HN_STORE_PATH}: ${persistedFetches.error ?? "Unknown error"}`,
+					"warning",
+				);
+			}
+
+			const readLookup = loadReadArticleIds(hits);
+			if (!readLookup.ok) {
+				ctx.ui.notify(
+					`Could not load read-article state from ${HN_STORE_PATH}: ${readLookup.error ?? "Unknown error"}`,
+					"warning",
+				);
+			}
+			const readArticleIds = readLookup.readIds;
+
+			const hitsById = new Map(hits.map((hit) => [hit.objectID, hit]));
+
+			await ctx.ui.custom<void>((tui, theme, _kb, done) => {
+				const items = hits.map((hit) => ({
+					value: hit.objectID,
+					label: formatListLabel(hit, readArticleIds.has(hit.objectID)),
+				}));
+				const itemsById = new Map(items.map((item) => [item.value, item]));
+
+				const pendingReadHits = new Map<string, HNHit>();
+				let uiClosed = false;
+				const flushPendingReads = () => {
+					const result = persistReadArticles([...pendingReadHits.values()]);
+					if (!result.ok) {
+						ctx.ui.notify(
+							`Could not persist read articles to ${HN_STORE_PATH}: ${result.error ?? "Unknown error"}`,
+							"warning",
+						);
+						return;
+					}
+					pendingReadHits.clear();
+				};
+
+				const closeUi = () => {
+					if (uiClosed) return;
+					uiClosed = true;
+					flushPendingReads();
+					done();
+				};
+
+				const container = new Container();
+				container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
+				container.addChild(new Text(theme.fg("accent", theme.bold("Hacker News"))));
+
+				const selectList = new SelectList(items, Math.min(items.length, 15), {
+					selectedPrefix: (text) => theme.fg("accent", text),
+					selectedText: (text) => theme.fg("accent", text),
+					description: (text) => theme.fg("muted", text),
+					scrollInfo: (text) => theme.fg("dim", text),
+					noMatch: (text) => theme.fg("warning", text),
+				});
+				let selectedIndex = 0;
+				selectList.onSelectionChange = (item) => {
+					selectedIndex = Math.max(
+						0,
+						items.findIndex((candidate) => candidate.value === item.value),
+					);
+				};
+
+				const getSelectedHit = (): HNHit | undefined => {
+					const selected = selectList.getSelectedItem();
+					if (!selected) return undefined;
+					return hitsById.get(selected.value);
+				};
+
+				const openSelectedArticle = async () => {
+					const hit = getSelectedHit();
+					if (!hit) return;
+					if (!hit.url) {
+						ctx.ui.notify("This item has no article URL.", "warning");
+						return;
+					}
+
+					const result = await openInBrowser(pi, hit.url);
+					if (!result.ok) {
+						ctx.ui.notify(`Could not open article: ${result.error ?? "Unknown error"}`, "error");
+						return;
+					}
+
+					pendingReadHits.set(hit.objectID, hit);
+					readArticleIds.add(hit.objectID);
+
+					if (uiClosed) {
+						flushPendingReads();
+						return;
+					}
+
+					const item = itemsById.get(hit.objectID);
+					if (item) {
+						item.label = formatListLabel(hit, true);
+						selectList.invalidate();
+						tui.requestRender();
+					}
+					if (pendingReadHits.size >= 10) {
+						flushPendingReads();
+					}
+				};
+
+				const openSelectedComments = async () => {
+					const hit = getSelectedHit();
+					if (!hit) return;
+
+					const result = await openInBrowser(pi, commentsUrl(hit));
+					if (!result.ok) {
+						ctx.ui.notify(`Could not open comments: ${result.error ?? "Unknown error"}`, "error");
+					}
+				};
+
+				selectList.onSelect = () => {
+					void openSelectedArticle();
+				};
+				selectList.onCancel = () => closeUi();
+
+				container.addChild(selectList);
+				container.addChild(
+					new Text(theme.fg("dim", "↑↓/j/k navigate • enter/a article • c comments • esc close")),
+				);
+				container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
+
+				return {
+					render(width: number) {
+						return container.render(width);
+					},
+					invalidate() {
+						container.invalidate();
+					},
+					handleInput(data: string) {
+						if (data === "a" || data === "A") {
+							void openSelectedArticle();
+							return;
+						}
+						if (data === "c" || data === "C") {
+							void openSelectedComments();
+							return;
+						}
+						if (data === "j" || data === "J") {
+							selectedIndex = (selectedIndex + 1) % items.length;
+							selectList.setSelectedIndex(selectedIndex);
+							tui.requestRender();
+							return;
+						}
+						if (data === "k" || data === "K") {
+							selectedIndex = (selectedIndex - 1 + items.length) % items.length;
+							selectList.setSelectedIndex(selectedIndex);
+							tui.requestRender();
+							return;
+						}
+
+						selectList.handleInput(data);
+						tui.requestRender();
+					},
+				};
+			});
+		},
+	});
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@calesennett/pi-hn",
+  "version": "0.1.0",
+  "description": "Hacker News front-page reader extension for pi",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "hacker-news",
+    "hn"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/calesennett/pi-hn.git"
+  },
+  "homepage": "https://github.com/calesennett/pi-hn#readme",
+  "bugs": {
+    "url": "https://github.com/calesennett/pi-hn/issues"
+  }
+}