pierre-review 0.1.0

package/dist/cli.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+import { execFile, execFileSync } from 'node:child_process';
+import { mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+// ── tiny ANSI helpers (degrade gracefully when not a TTY) ──────────────────
+const useColor = process.stdout.isTTY && process.env.NO_COLOR === undefined;
+const paint = (code, s) => useColor ? `[${code}m${s}` : s;
+const cyan = (s) => paint('36', s);
+const dim = (s) => paint('2', s);
+const bold = (s) => paint('1', s);
+function parseArgs(argv) {
+    const opts = { open: true, help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case '--no-open':
+                opts.open = false;
+                break;
+            case '--port': {
+                const v = argv[++i];
+                const n = v ? Number.parseInt(v, 10) : NaN;
+                if (!Number.isFinite(n)) {
+                    console.error('--port requires a number');
+                    process.exit(1);
+                }
+                opts.port = n;
+                break;
+            }
+            case '--db': {
+                const v = argv[++i];
+                if (!v) {
+                    console.error('--db requires a path');
+                    process.exit(1);
+                }
+                opts.db = v;
+                break;
+            }
+            case '--help':
+            case '-h':
+                opts.help = true;
+                break;
+            default:
+                console.error(`Unknown argument: ${arg}`);
+                console.error('Run `pierre --help` for usage.');
+                process.exit(1);
+        }
+    }
+    return opts;
+}
+function printUsage() {
+    console.log(`pierre — ${'local-only GitHub PR activity dashboard'}
+
+Usage:
+  pierre [options]
+  pierre-review [options]
+
+Options:
+  --no-open        Don't open the browser (also honours NO_OPEN env)
+  --port <n>       Port to listen on (also PORT env, default 4000)
+  --db <path>      SQLite DB path (also DATABASE_URL env)
+  -h, --help       Show this help
+
+Prerequisite:
+  Requires the GitHub CLI (https://cli.github.com), authenticated via
+  \`gh auth login\`. The dashboard reads your activity using your gh token.
+`);
+}
+// Cross-platform browser open — no extra dependency.
+function openBrowser(url) {
+    const platform = process.platform;
+    const cmd = platform === 'darwin' ? 'open' : platform === 'win32' ? 'cmd' : 'xdg-open';
+    const args = platform === 'win32' ? ['/c', 'start', '""', url] : [url];
+    // Swallow failures — headless / no-DE environments are fine.
+    execFile(cmd, args, () => {
+        /* ignore */
+    });
+}
+async function main() {
+    const opts = parseArgs(process.argv.slice(2));
+    if (opts.help) {
+        printUsage();
+        process.exit(0);
+    }
+    // ── map flags → env BEFORE importing config/app (config reads these) ──────
+    if (opts.port !== undefined)
+        process.env.PORT = String(opts.port);
+    if (opts.db !== undefined)
+        process.env.DATABASE_URL = opts.db;
+    if (opts.open === false)
+        process.env.NO_OPEN = '1';
+    // Production mode: skip pino-pretty (not shipped) and enable static serving.
+    process.env.NODE_ENV ??= 'production';
+    // ── default the DB to a user-writable home location (mkdir -p) ────────────
+    // The package dir is read-only for global installs, so never write there.
+    if (!process.env.DATABASE_URL) {
+        const dbPath = join(homedir(), '.pierre-review', 'pierre-review.sqlite');
+        process.env.DATABASE_URL = dbPath;
+    }
+    try {
+        mkdirSync(dirname(process.env.DATABASE_URL), { recursive: true });
+    }
+    catch {
+        /* best-effort; client.ts also mkdirs */
+    }
+    // ── pre-check gh auth with a friendly message (contract §6) ───────────────
+    try {
+        execFileSync('gh', ['auth', 'token'], { stdio: 'ignore' });
+    }
+    catch {
+        console.error('');
+        console.error(bold('GitHub CLI not found or not authenticated.'));
+        console.error('Install the GitHub CLI (https://cli.github.com) and run `gh auth login`.');
+        console.error('');
+        process.exit(1);
+    }
+    const port = process.env.PORT ? Number.parseInt(process.env.PORT, 10) : 4000;
+    const url = `http://localhost:${port}`;
+    // ── banner ────────────────────────────────────────────────────────────────
+    const { PIERRE_ASCII, TAGLINE } = await import('./ascii.js');
+    console.log(cyan(PIERRE_ASCII));
+    console.log(`  ${dim(TAGLINE)}`);
+    console.log('');
+    console.log(`  ${cyan('▸')} ${bold(url)}`);
+    console.log('');
+    // ── boot the server (migrate → user → app → scheduler → listen) ───────────
+    const { start } = await import('./index.js');
+    await start();
+    // ── open the browser once we're listening ─────────────────────────────────
+    const skipOpen = opts.open === false || process.env.NO_OPEN !== undefined;
+    if (!skipOpen)
+        openBrowser(url);
+}
+main().catch((err) => {
+    console.error('Failed to start pierre:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/config.js

@@ -0,0 +1,41 @@
+import { homedir } from 'node:os';
+import { isAbsolute, join, resolve } from 'node:path';
+// apps/backend as the base for relative paths regardless of cwd.
+const backendRoot = resolve(import.meta.dirname, '..');
+// Load .env from the repo root and (optionally) apps/backend before reading
+// any config. Node's loader no-ops politely if a file is missing.
+for (const envPath of [
+    resolve(backendRoot, '../../.env'),
+    resolve(backendRoot, '.env'),
+]) {
+    try {
+        process.loadEnvFile(envPath);
+    }
+    catch {
+        /* no .env at this location */
+    }
+}
+function intFromEnv(key, fallback) {
+    const raw = process.env[key];
+    if (!raw)
+        return fallback;
+    const n = Number.parseInt(raw, 10);
+    return Number.isFinite(n) ? n : fallback;
+}
+// Default the SQLite DB to a user-writable location in the home dir so the app
+// works when installed globally (the package dir is read-only). DATABASE_URL /
+// --db override this; a relative override resolves under apps/backend (dev).
+const defaultDbPath = join(homedir(), '.pierre-review', 'pierre-review.sqlite');
+const rawDbUrl = process.env.DATABASE_URL ?? defaultDbPath;
+export const config = {
+    port: intFromEnv('PORT', 4000),
+    host: process.env.HOST ?? '127.0.0.1',
+    dbPath: isAbsolute(rawDbUrl) ? rawDbUrl : resolve(backendRoot, rawDbUrl),
+    backfillDays: intFromEnv('BACKFILL_DAYS', 90),
+    syncCron: process.env.SYNC_CRON ?? '*/5 * * * *',
+    syncOverlapMinutes: intFromEnv('SYNC_OVERLAP_MINUTES', 20),
+    stallThresholdDays: intFromEnv('STALL_THRESHOLD_DAYS', 3),
+    // Disable the periodic scheduler (used by scripts/tests).
+    disableScheduler: process.env.DISABLE_SCHEDULER === 'true',
+};
+//# sourceMappingURL=config.js.map

package/dist/db/cleanup.js

@@ -0,0 +1,22 @@
+import { sqlite } from './client.js';
+// One-time / idempotent maintenance run at startup.
+//
+// GitHub wraps inline-only reviews in an empty "commented" review, which the
+// sync used to record as a `review_submitted` event. Those wrappers duplicate
+// the inline `review_comment` markers on the timeline. New syncs no longer emit
+// them (see sync/upsert.ts), but pre-existing rows linger because upserts only
+// update. This removes them; it also catches reviews whose summary body was
+// later cleared on GitHub. Cheap and safe to run every boot.
+export function cleanupRedundantReviewEvents() {
+    const res = sqlite
+        .prepare(`DELETE FROM events
+         WHERE type = 'review_submitted'
+           AND ref_table = 'reviews'
+           AND ref_id IN (
+             SELECT id FROM reviews
+               WHERE state = 'commented' AND (body IS NULL OR trim(body) = '')
+           )`)
+        .run();
+    return res.changes;
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/db/client.js

@@ -0,0 +1,13 @@
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import Database from 'better-sqlite3';
+import { drizzle } from 'drizzle-orm/better-sqlite3';
+import { config } from '../config.js';
+import * as schema from './schema.js';
+mkdirSync(dirname(config.dbPath), { recursive: true });
+export const sqlite = new Database(config.dbPath);
+sqlite.pragma('journal_mode = WAL');
+sqlite.pragma('foreign_keys = ON');
+export const db = drizzle(sqlite, { schema });
+export { schema };
+//# sourceMappingURL=client.js.map

package/dist/db/migrate.js

@@ -0,0 +1,15 @@
+// Applies pending drizzle migrations, then exits. Run via `pnpm db:migrate`.
+import { sqlite } from './client.js';
+import { runMigrations } from './run-migrations.js';
+try {
+    runMigrations();
+    console.log('Migrations applied.');
+}
+catch (err) {
+    console.error('Migration failed:', err);
+    process.exitCode = 1;
+}
+finally {
+    sqlite.close();
+}
+//# sourceMappingURL=migrate.js.map

package/dist/db/migrations/0000_purple_ben_grimm.sql

@@ -0,0 +1,155 @@
+CREATE TABLE `commit_files` (
+	`sha` text PRIMARY KEY NOT NULL,
+	`paths` text NOT NULL,
+	`fetched_at` integer DEFAULT (unixepoch()) NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE `commits` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`sha` text NOT NULL,
+	`pr_id` integer NOT NULL,
+	`author_id` integer,
+	`committer_id` integer,
+	`message` text,
+	`committed_at` integer NOT NULL,
+	FOREIGN KEY (`pr_id`) REFERENCES `pull_requests`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`author_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`committer_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE INDEX `commit_pr_idx` ON `commits` (`pr_id`);--> statement-breakpoint
+CREATE UNIQUE INDEX `commit_sha_pr_ux` ON `commits` (`sha`,`pr_id`);--> statement-breakpoint
+CREATE TABLE `events` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`repo_id` integer NOT NULL,
+	`actor_id` integer,
+	`pr_id` integer,
+	`type` text NOT NULL,
+	`occurred_at` integer NOT NULL,
+	`ref_table` text,
+	`ref_id` integer,
+	`dedupe_key` text NOT NULL,
+	FOREIGN KEY (`repo_id`) REFERENCES `repos`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`actor_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`pr_id`) REFERENCES `pull_requests`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `events_dedupe_key_unique` ON `events` (`dedupe_key`);--> statement-breakpoint
+CREATE INDEX `events_time_idx` ON `events` (`occurred_at`);--> statement-breakpoint
+CREATE INDEX `events_repo_time_idx` ON `events` (`repo_id`,`occurred_at`);--> statement-breakpoint
+CREATE INDEX `events_actor_idx` ON `events` (`actor_id`);--> statement-breakpoint
+CREATE TABLE `pr_comments` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`github_node_id` text NOT NULL,
+	`pr_id` integer NOT NULL,
+	`author_id` integer,
+	`body` text NOT NULL,
+	`created_at` integer NOT NULL,
+	FOREIGN KEY (`pr_id`) REFERENCES `pull_requests`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`author_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `pr_comments_github_node_id_unique` ON `pr_comments` (`github_node_id`);--> statement-breakpoint
+CREATE INDEX `prc_pr_idx` ON `pr_comments` (`pr_id`);--> statement-breakpoint
+CREATE TABLE `pull_requests` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`github_node_id` text NOT NULL,
+	`repo_id` integer NOT NULL,
+	`number` integer NOT NULL,
+	`title` text NOT NULL,
+	`body` text,
+	`author_id` integer,
+	`state` text NOT NULL,
+	`is_draft` integer DEFAULT false NOT NULL,
+	`opened_at` integer NOT NULL,
+	`first_review_at` integer,
+	`last_commit_at` integer,
+	`merged_at` integer,
+	`closed_at` integer,
+	`updated_at` integer NOT NULL,
+	FOREIGN KEY (`repo_id`) REFERENCES `repos`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`author_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `pull_requests_github_node_id_unique` ON `pull_requests` (`github_node_id`);--> statement-breakpoint
+CREATE INDEX `pr_repo_idx` ON `pull_requests` (`repo_id`);--> statement-breakpoint
+CREATE INDEX `pr_opened_idx` ON `pull_requests` (`opened_at`);--> statement-breakpoint
+CREATE TABLE `repos` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`owner` text NOT NULL,
+	`name` text NOT NULL,
+	`github_node_id` text NOT NULL,
+	`backfill_until` integer,
+	`created_at` integer DEFAULT (unixepoch()) NOT NULL
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `repos_github_node_id_unique` ON `repos` (`github_node_id`);--> statement-breakpoint
+CREATE UNIQUE INDEX `repos_owner_name` ON `repos` (`owner`,`name`);--> statement-breakpoint
+CREATE TABLE `review_comments` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`github_node_id` text NOT NULL,
+	`thread_id` integer NOT NULL,
+	`pr_id` integer NOT NULL,
+	`author_id` integer,
+	`body` text NOT NULL,
+	`diff_hunk` text,
+	`created_at` integer NOT NULL,
+	FOREIGN KEY (`thread_id`) REFERENCES `review_threads`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`pr_id`) REFERENCES `pull_requests`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`author_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `review_comments_github_node_id_unique` ON `review_comments` (`github_node_id`);--> statement-breakpoint
+CREATE INDEX `rc_thread_idx` ON `review_comments` (`thread_id`);--> statement-breakpoint
+CREATE TABLE `review_threads` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`github_node_id` text NOT NULL,
+	`pr_id` integer NOT NULL,
+	`path` text NOT NULL,
+	`line` integer,
+	`is_resolved` integer NOT NULL,
+	`is_outdated` integer DEFAULT false NOT NULL,
+	`derived_state` text NOT NULL,
+	`original_commenter_id` integer,
+	`created_at` integer NOT NULL,
+	FOREIGN KEY (`pr_id`) REFERENCES `pull_requests`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`original_commenter_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `review_threads_github_node_id_unique` ON `review_threads` (`github_node_id`);--> statement-breakpoint
+CREATE INDEX `thread_pr_idx` ON `review_threads` (`pr_id`);--> statement-breakpoint
+CREATE TABLE `reviews` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`github_node_id` text NOT NULL,
+	`pr_id` integer NOT NULL,
+	`author_id` integer,
+	`state` text NOT NULL,
+	`body` text,
+	`submitted_at` integer NOT NULL,
+	FOREIGN KEY (`pr_id`) REFERENCES `pull_requests`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`author_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `reviews_github_node_id_unique` ON `reviews` (`github_node_id`);--> statement-breakpoint
+CREATE INDEX `rv_pr_idx` ON `reviews` (`pr_id`);--> statement-breakpoint
+CREATE TABLE `sync_state` (
+	`repo_id` integer PRIMARY KEY NOT NULL,
+	`last_full_sync_at` integer,
+	`last_incremental_sync_at` integer,
+	`last_sync_status` text,
+	`last_sync_error` text,
+	FOREIGN KEY (`repo_id`) REFERENCES `repos`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE TABLE `users` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`github_login` text NOT NULL,
+	`github_node_id` text,
+	`display_name` text,
+	`avatar_url` text,
+	`is_bot` integer DEFAULT false NOT NULL,
+	`is_bot_overridden` integer DEFAULT false NOT NULL
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `users_github_login_unique` ON `users` (`github_login`);--> statement-breakpoint
+CREATE UNIQUE INDEX `users_github_node_id_unique` ON `users` (`github_node_id`);

package/dist/db/migrations/0001_colorful_ozymandias.sql

@@ -0,0 +1,31 @@
+CREATE TABLE `local_user` (
+	`id` integer PRIMARY KEY NOT NULL,
+	`github_login` text NOT NULL,
+	`github_id` text NOT NULL,
+	`avatar_url` text,
+	`cached_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE `pr_views` (
+	`pr_id` integer PRIMARY KEY NOT NULL,
+	`last_viewed_sha` text,
+	`last_viewed_at` integer NOT NULL,
+	FOREIGN KEY (`pr_id`) REFERENCES `pull_requests`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE TABLE `review_requests` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`pr_id` integer NOT NULL,
+	`user_id` integer,
+	`team_name` text,
+	FOREIGN KEY (`pr_id`) REFERENCES `pull_requests`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE INDEX `rr_pr_idx` ON `review_requests` (`pr_id`);--> statement-breakpoint
+CREATE INDEX `rr_user_idx` ON `review_requests` (`user_id`);--> statement-breakpoint
+ALTER TABLE `pull_requests` ADD `head_sha` text;--> statement-breakpoint
+ALTER TABLE `pull_requests` ADD `ci_status` text;--> statement-breakpoint
+ALTER TABLE `pull_requests` ADD `mergeable` text;--> statement-breakpoint
+ALTER TABLE `pull_requests` ADD `merge_state_status` text;--> statement-breakpoint
+ALTER TABLE `pull_requests` ADD `labels` text;

package/dist/db/migrations/0002_famous_sersi.sql

@@ -0,0 +1,9 @@
+CREATE TABLE `my_turn_dismissals` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`kind` text NOT NULL,
+	`ref_id` integer NOT NULL,
+	`dismissed_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `mtd_kind_ref_ux` ON `my_turn_dismissals` (`kind`,`ref_id`);--> statement-breakpoint
+ALTER TABLE `pull_requests` ADD `check_runs` text;

package/dist/db/migrations/0003_clever_shinobi_shaw.sql

@@ -0,0 +1,3 @@
+ALTER TABLE `pr_comments` ADD `database_id` text;--> statement-breakpoint
+ALTER TABLE `review_comments` ADD `database_id` text;--> statement-breakpoint
+ALTER TABLE `reviews` ADD `database_id` text;

package/dist/db/migrations/0004_pale_scalphunter.sql

@@ -0,0 +1 @@
+ALTER TABLE `pull_requests` ADD `merged_by_id` integer REFERENCES users(id);

package/dist/db/migrations/0005_daffy_guardian.sql

@@ -0,0 +1,2 @@
+ALTER TABLE `pull_requests` ADD `base_ref_name` text;--> statement-breakpoint
+ALTER TABLE `repos` ADD `default_branch` text;