npm - mergie-cli - Versions diffs - 0.1.0 - Mend

mergie-cli 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (140) hide show

package/LICENSE +674 -0
package/README.md +91 -0
package/bin/mergie-dev +18 -0
package/bin/mergie.ts +44 -0
package/dist/web/assets/index-4bq8mkyV.css +1 -0
package/dist/web/assets/index-Cp_Gdwf2.js +50 -0
package/dist/web/favicon.svg +12 -0
package/dist/web/index.html +14 -0
package/package.json +68 -0
package/src/cli/args.ts +63 -0
package/src/cli/constants.ts +32 -0
package/src/cli/daemonClient.ts +42 -0
package/src/cli/openBrowser.ts +11 -0
package/src/cli/run.ts +76 -0
package/src/daemon/aiReviewTracker.ts +71 -0
package/src/daemon/allComments.ts +119 -0
package/src/daemon/artifactCapture.ts +47 -0
package/src/daemon/buildUi.ts +54 -0
package/src/daemon/chatPrompt.ts +35 -0
package/src/daemon/chatSocket.ts +78 -0
package/src/daemon/createRegistry.ts +569 -0
package/src/daemon/githubThreads.ts +92 -0
package/src/daemon/inflight.ts +49 -0
package/src/daemon/postMapping.ts +94 -0
package/src/daemon/registry.ts +263 -0
package/src/daemon/reviewPrompt.ts +22 -0
package/src/daemon/reviewService.ts +243 -0
package/src/daemon/router.ts +287 -0
package/src/daemon/server.ts +106 -0
package/src/daemon/splitView.ts +63 -0
package/src/daemon/trpc.ts +20 -0
package/src/db/migrate.ts +24 -0
package/src/db/repositories/aiReviews.ts +113 -0
package/src/db/repositories/artifacts.ts +101 -0
package/src/db/repositories/chatSessions.ts +197 -0
package/src/db/repositories/comments.ts +195 -0
package/src/db/repositories/githubComments.ts +166 -0
package/src/db/repositories/hunkViews.ts +36 -0
package/src/db/repositories/reviewedRanges.ts +75 -0
package/src/db/schema.ts +97 -0
package/src/domain/config.ts +137 -0
package/src/domain/context.ts +32 -0
package/src/domain/diff.ts +178 -0
package/src/domain/entities.ts +92 -0
package/src/domain/fuzzy.ts +43 -0
package/src/domain/generated.ts +33 -0
package/src/domain/hash.ts +0 -0
package/src/domain/lockfiles.ts +20 -0
package/src/domain/paths.ts +59 -0
package/src/domain/ranges.ts +81 -0
package/src/domain/references.ts +36 -0
package/src/domain/url.ts +50 -0
package/src/domain/wordDiff.ts +174 -0
package/src/services/ai.ts +137 -0
package/src/services/exec.ts +44 -0
package/src/services/ghPr.ts +102 -0
package/src/services/ghSearch.ts +135 -0
package/src/services/git.ts +297 -0
package/src/services/github.ts +300 -0
package/src/services/symbols.ts +364 -0
package/src/web/App.tsx +32 -0
package/src/web/components/AiReviewIndicator.tsx +63 -0
package/src/web/components/AiReviewModal.tsx +101 -0
package/src/web/components/AiReviewsPanel.tsx +64 -0
package/src/web/components/ChatPanel.tsx +142 -0
package/src/web/components/CodePreview.tsx +63 -0
package/src/web/components/CommentComposer.tsx +40 -0
package/src/web/components/CommentItem.tsx +59 -0
package/src/web/components/CommentsPanel.tsx +309 -0
package/src/web/components/CommitRail.tsx +64 -0
package/src/web/components/ConfirmButton.tsx +32 -0
package/src/web/components/CopyButton.tsx +33 -0
package/src/web/components/CopyIconButton.tsx +38 -0
package/src/web/components/DiffFrame.tsx +133 -0
package/src/web/components/DiffLines.tsx +149 -0
package/src/web/components/FileFrame.tsx +45 -0
package/src/web/components/FileNavigator.tsx +195 -0
package/src/web/components/FileTree.tsx +45 -0
package/src/web/components/FileView.tsx +53 -0
package/src/web/components/GithubThreadView.tsx +56 -0
package/src/web/components/HunkCard.tsx +121 -0
package/src/web/components/Icons.tsx +215 -0
package/src/web/components/IdentifierMenuPortal.tsx +33 -0
package/src/web/components/PostMenu.tsx +63 -0
package/src/web/components/PrDescription.tsx +29 -0
package/src/web/components/PrLoading.tsx +45 -0
package/src/web/components/PrPicker.tsx +201 -0
package/src/web/components/RangeSelector.tsx +141 -0
package/src/web/components/ResultsList.tsx +159 -0
package/src/web/components/ReviewView.tsx +308 -0
package/src/web/components/RightRail.tsx +146 -0
package/src/web/components/SearchRailPanel.tsx +127 -0
package/src/web/components/Switch.tsx +31 -0
package/src/web/components/SwitchPrModal.tsx +28 -0
package/src/web/components/SymbolLookupMenu.tsx +35 -0
package/src/web/components/Toolbar.tsx +79 -0
package/src/web/components/Tooltip.tsx +72 -0
package/src/web/index.html +13 -0
package/src/web/lib/aiReviewIndicator.ts +29 -0
package/src/web/lib/anchorRow.ts +25 -0
package/src/web/lib/codeSearchFetch.ts +46 -0
package/src/web/lib/commentFilters.ts +36 -0
package/src/web/lib/commentVisibility.ts +90 -0
package/src/web/lib/composerKeys.ts +24 -0
package/src/web/lib/dedupeResults.ts +37 -0
package/src/web/lib/diffMarks.ts +81 -0
package/src/web/lib/fileStatus.ts +12 -0
package/src/web/lib/filterCodeResults.ts +42 -0
package/src/web/lib/filterPrs.ts +38 -0
package/src/web/lib/highlight.ts +40 -0
package/src/web/lib/identifierMenu.ts +41 -0
package/src/web/lib/lineSelection.ts +48 -0
package/src/web/lib/navRouting.ts +40 -0
package/src/web/lib/navStack.ts +109 -0
package/src/web/lib/persistedFlag.ts +43 -0
package/src/web/lib/prPickerModel.ts +27 -0
package/src/web/lib/railState.ts +19 -0
package/src/web/lib/rangeCoverage.ts +27 -0
package/src/web/lib/rangeMap.ts +42 -0
package/src/web/lib/resultCountLabel.ts +11 -0
package/src/web/lib/reviewProgress.ts +26 -0
package/src/web/lib/searchInputsKey.ts +35 -0
package/src/web/lib/searchToken.ts +25 -0
package/src/web/lib/splitSide.ts +13 -0
package/src/web/lib/time.ts +9 -0
package/src/web/lib/togglePrefs.ts +81 -0
package/src/web/lib/useEscToClose.ts +17 -0
package/src/web/lib/useIdentifierMenu.ts +77 -0
package/src/web/lib/useNavLookup.ts +74 -0
package/src/web/lib/usePageTitle.ts +15 -0
package/src/web/lib/visibleFiles.ts +52 -0
package/src/web/main.tsx +24 -0
package/src/web/public/favicon.svg +12 -0
package/src/web/state/useChat.ts +181 -0
package/src/web/state/useCodeSearch.ts +198 -0
package/src/web/state/useReview.ts +138 -0
package/src/web/styles.css +1020 -0
package/src/web/trpc.ts +5 -0
package/tsconfig.json +27 -0
package/vite.config.ts +29 -0

package/dist/web/favicon.svg ADDED Viewed

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" role="img" aria-label="mergie">
+  <rect width="32" height="32" rx="7" fill="#ffffff"/>
+  <!-- added line: green "+" and bar -->
+  <line x1="8" y1="8" x2="8" y2="12" stroke="#2da44e" stroke-width="2" stroke-linecap="round"/>
+  <line x1="6" y1="10" x2="10" y2="10" stroke="#2da44e" stroke-width="2" stroke-linecap="round"/>
+  <rect x="13" y="8.5" width="13" height="3" rx="1.5" fill="#2da44e"/>
+  <!-- removed line: red "−" and bar -->
+  <line x1="6" y1="16" x2="10" y2="16" stroke="#cf222e" stroke-width="2" stroke-linecap="round"/>
+  <rect x="13" y="14.5" width="10" height="3" rx="1.5" fill="#cf222e"/>
+  <!-- context line -->
+  <rect x="13" y="20.5" width="8" height="3" rx="1.5" fill="#c8d1da"/>
+</svg>

package/dist/web/index.html ADDED Viewed

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <title>mergie</title>
+    <script type="module" crossorigin src="/assets/index-Cp_Gdwf2.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-4bq8mkyV.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/package.json ADDED Viewed

@@ -0,0 +1,68 @@
+{
+  "name": "mergie-cli",
+  "version": "0.1.0",
+  "description": "Review GitHub pull requests from a fast local web UI, driven by a small CLI.",
+  "license": "GPL-3.0-or-later",
+  "author": "Ayush Poddar",
+  "homepage": "https://github.com/ayushpoddar/mergie#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ayushpoddar/mergie.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ayushpoddar/mergie/issues"
+  },
+  "keywords": [
+    "github",
+    "pull-request",
+    "code-review",
+    "diff",
+    "cli",
+    "bun",
+    "review"
+  ],
+  "type": "module",
+  "engines": {
+    "bun": ">=1.2.0"
+  },
+  "bin": {
+    "mergie": "./bin/mergie.ts"
+  },
+  "files": [
+    "bin",
+    "src",
+    "dist",
+    "vite.config.ts",
+    "tsconfig.json"
+  ],
+  "scripts": {
+    "start": "bun run bin/mergie.ts",
+    "dev:web": "vite",
+    "build:web": "vite build",
+    "prepack": "bun run build:web",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "test:e2e": "bun test e2e"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "0.3.177",
+    "@tanstack/react-query": "5.101.0",
+    "@trpc/client": "11.17.0",
+    "@trpc/react-query": "11.17.0",
+    "@trpc/server": "11.17.0",
+    "highlight.js": "11.11.1",
+    "react": "19.2.7",
+    "react-dom": "19.2.7",
+    "react-markdown": "10.1.0",
+    "remark-gfm": "4.0.1",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@types/bun": "1.3.14",
+    "@types/react": "19.2.17",
+    "@types/react-dom": "19.2.3",
+    "@vitejs/plugin-react": "4.7.0",
+    "typescript": "5.9.3",
+    "vite": "7.3.5"
+  }
+}

package/src/cli/args.ts ADDED Viewed

@@ -0,0 +1,63 @@
+/** A parsed CLI command. */
+export type Command =
+  | { kind: "open"; noOpen: boolean }
+  | { kind: "review"; url: string; noOpen: boolean }
+  | { kind: "reload"; noOpen: boolean }
+  | { kind: "stop" }
+  | { kind: "status" };
+/** Usage text shown on parse errors. */
+export const USAGE =
+  "Usage: mergie [--pr <pull-request-url>] [--no-open] | mergie reload | mergie stop | mergie status";
+/** The flag that suppresses auto-opening the browser tab. */
+const NO_OPEN = "--no-open";
+/**
+ * Parse mergie's CLI arguments into a {@link Command}.
+ *
+ * With no arguments mergie opens the home picker (no PR selected). `--pr <url>`
+ * deep-links into a PR; `reload` restarts the daemon; `--no-open` (valid on any
+ * open flow) skips launching the browser.
+ *
+ * @param argv Arguments after the executable/script (e.g. `process.argv.slice(2)`).
+ * @throws If the arguments are unknown, `--pr` has no value, or `--no-open` is
+ *   combined with a non-open command (`stop`/`status`).
+ */
+export function parseArgs(argv: string[]): Command {
+  const noOpen: boolean = argv.includes(NO_OPEN);
+  const rest: string[] = argv.filter((a) => a !== NO_OPEN);
+  const first: string | undefined = rest[0];
+  if (first === "stop" || first === "status") {
+    if (noOpen) throw new Error(`${NO_OPEN} is not valid with ${first}.\n${USAGE}`);
+    return { kind: first };
+  }
+  if (first === undefined) return { kind: "open", noOpen };
+  if (first === "reload") return { kind: "reload", noOpen };
+  const url: string | undefined = prUrlFrom(first, rest[1]);
+  if (url !== undefined) return { kind: "review", url, noOpen };
+  throw new Error(`Unknown command: ${first}\n${USAGE}`);
+}
+/**
+ * Extract a PR URL from a `--pr <url>` pair or a `--pr=<url>` token, or return
+ * undefined if `first` is not a `--pr` flag.
+ *
+ * @throws If a `--pr` flag is present but its value is empty.
+ */
+function prUrlFrom(first: string, next: string | undefined): string | undefined {
+  if (first === "--pr") {
+    if (next === undefined || next.length === 0) throw new Error(`Missing PR URL.\n${USAGE}`);
+    return next;
+  }
+  if (first.startsWith("--pr=")) {
+    const url: string = first.slice("--pr=".length);
+    if (url.length === 0) throw new Error(`Missing PR URL.\n${USAGE}`);
+    return url;
+  }
+  return undefined;
+}

package/src/cli/constants.ts ADDED Viewed

@@ -0,0 +1,32 @@
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+/** Port the daemon binds to when `MERGIE_PORT` is unset or invalid. */
+export const DEFAULT_PORT = 4517;
+/**
+ * Resolve the daemon port from the environment. Honours a valid `MERGIE_PORT`
+ * (an integer in 1–65535), otherwise falls back to {@link DEFAULT_PORT}. This
+ * lets a second instance (e.g. a dev worktree) run on its own port without
+ * colliding with the primary daemon.
+ */
+export function resolvePort(env: Record<string, string | undefined> = process.env): number {
+  const raw: string | undefined = env.MERGIE_PORT;
+  const n: number = raw ? Number(raw) : NaN;
+  return Number.isInteger(n) && n >= 1 && n <= 65535 ? n : DEFAULT_PORT;
+}
+/** Port the daemon binds to (overridable via `MERGIE_PORT`). */
+export const DAEMON_PORT: number = resolvePort();
+/** Base URL of the local daemon. */
+export const DAEMON_URL = `http://localhost:${DAEMON_PORT}`;
+/** Repository root (two levels up from this file: src/cli → root). */
+export const ROOT: string = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
+/** Path to the built web UI served by the daemon. */
+export const DIST_DIR: string = join(ROOT, "dist", "web");
+/** Path to the CLI entry script (used to spawn the daemon process). */
+export const BIN_PATH: string = join(ROOT, "bin", "mergie.ts");

package/src/cli/daemonClient.ts ADDED Viewed

@@ -0,0 +1,42 @@
+import { createTRPCClient, httpBatchLink } from "@trpc/client";
+import type { AppRouter } from "@/daemon/router.ts";
+import { BIN_PATH, DAEMON_PORT, DAEMON_URL } from "./constants.ts";
+/** A typed tRPC client for the local daemon. */
+export type DaemonClient = ReturnType<typeof createTRPCClient<AppRouter>>;
+/** Build a tRPC client pointed at the local daemon. */
+export function makeClient(url: string = DAEMON_URL): DaemonClient {
+  return createTRPCClient<AppRouter>({ links: [httpBatchLink({ url: `${url}/trpc` })] });
+}
+/** Whether a daemon is already answering on the given URL. */
+export async function isHealthy(url: string = DAEMON_URL): Promise<boolean> {
+  try {
+    const res = await fetch(`${url}/trpc/health`, { signal: AbortSignal.timeout(1000) });
+    return res.ok;
+  } catch {
+    return false;
+  }
+}
+/**
+ * Ensure a daemon is running: if none is healthy, spawn a detached daemon
+ * process and wait until it responds (or time out).
+ */
+export async function ensureDaemon(url: string = DAEMON_URL): Promise<void> {
+  if (await isHealthy(url)) return;
+  Bun.spawn(["bun", "run", BIN_PATH, "__daemon"], {
+    stdout: "ignore",
+    stderr: "ignore",
+    stdin: "ignore",
+    env: { ...process.env, MERGIE_PORT: String(DAEMON_PORT) },
+  }).unref();
+  const deadline: number = performance.now() + 15000;
+  while (performance.now() < deadline) {
+    await Bun.sleep(200);
+    if (await isHealthy(url)) return;
+  }
+  throw new Error("Daemon did not become healthy within 15s");
+}

package/src/cli/openBrowser.ts ADDED Viewed

@@ -0,0 +1,11 @@
+import { bunRunner, type CommandRunner } from "@/services/exec.ts";
+/**
+ * Open a URL in the default browser (macOS `open`).
+ *
+ * @param url    URL to open.
+ * @param runner Command runner (injectable for tests).
+ */
+export async function openBrowser(url: string, runner: CommandRunner = bunRunner): Promise<void> {
+  await runner.run("open", [url]);
+}

package/src/cli/run.ts ADDED Viewed

@@ -0,0 +1,76 @@
+import type { Command } from "./args.ts";
+import { DAEMON_URL } from "./constants.ts";
+import { ensureDaemon, isHealthy, makeClient } from "./daemonClient.ts";
+import { openBrowser } from "./openBrowser.ts";
+/** Execute a parsed CLI {@link Command}. */
+export async function runCli(cmd: Command): Promise<void> {
+  if (cmd.kind === "review") return runReview(cmd.url, cmd.noOpen);
+  if (cmd.kind === "open") return runOpen(cmd.noOpen);
+  if (cmd.kind === "reload") return runReload(cmd.noOpen);
+  if (cmd.kind === "stop") return runStop();
+  return runStatus();
+}
+/** Open the home picker (no PR selected). */
+async function runOpen(noOpen: boolean): Promise<void> {
+  await ensureDaemon();
+  await maybeOpen(`${DAEMON_URL}/`, noOpen);
+}
+/** Load a PR by URL and open it directly. */
+async function runReview(url: string, noOpen: boolean): Promise<void> {
+  await ensureDaemon();
+  const pr = await makeClient().loadPr.mutate({ url });
+  console.log(`Loaded ${pr.owner}/${pr.repo} #${pr.number}: ${pr.title}`);
+  await maybeOpen(`${DAEMON_URL}/?pr=${pr.id}`, noOpen);
+}
+/** Restart the daemon (stop, wait for exit, then open the home picker). */
+async function runReload(noOpen: boolean): Promise<void> {
+  await stopAndWait();
+  await runOpen(noOpen);
+}
+async function runStop(): Promise<void> {
+  if (!(await isHealthy())) {
+    console.log("Daemon is not running.");
+    return;
+  }
+  await makeClient().stop.mutate();
+  console.log("Daemon stopping.");
+}
+async function runStatus(): Promise<void> {
+  if (!(await isHealthy())) {
+    console.log("Daemon is not running.");
+    return;
+  }
+  const health = await makeClient().health.query();
+  console.log(`Daemon running. ${health.prs.length} PR(s) loaded.`);
+  for (const pr of health.prs) {
+    console.log(`  - ${pr.owner}/${pr.repo} #${pr.number}: ${pr.title}`);
+  }
+}
+/** Open a URL in the browser unless suppressed, always logging the target. */
+async function maybeOpen(target: string, noOpen: boolean): Promise<void> {
+  if (noOpen) {
+    console.log(`Ready at ${target}`);
+    return;
+  }
+  console.log(`Opening ${target}`);
+  await openBrowser(target);
+}
+/** Ask a running daemon to stop, then poll until it stops answering. */
+async function stopAndWait(): Promise<void> {
+  if (!(await isHealthy())) return;
+  await makeClient().stop.mutate();
+  const deadline: number = performance.now() + 15000;
+  while (performance.now() < deadline) {
+    await Bun.sleep(200);
+    if (!(await isHealthy())) return;
+  }
+  throw new Error("Daemon did not stop within 15s");
+}

package/src/daemon/aiReviewTracker.ts ADDED Viewed

@@ -0,0 +1,71 @@
+import type { ChatRange } from "./registry.ts";
+/** Lifecycle state of an AI review the UI can observe. */
+export type AiReviewState = "running" | "done" | "failed";
+/** Observable status of one AI review, keyed by its commit range. */
+export interface AiReviewStatus {
+  /** Range baseline SHA. */
+  startSha: string;
+  /** Range end SHA. */
+  endSha: string;
+  /** Current lifecycle state. */
+  state: AiReviewState;
+  /** Persisted review row id once done; null while running or on failure. */
+  reviewId: number | null;
+  /** Error message when failed; null otherwise. */
+  error: string | null;
+}
+/**
+ * Per-PR tracker of in-flight and recently-completed AI reviews, keyed by
+ * commit range. Lets the UI show a persistent "review in progress / ready /
+ * failed" indicator independent of whichever popup started the run. A completed
+ * (done/failed) entry lingers until explicitly dismissed (e.g. after the user
+ * clicks through to the result); a running entry cannot be dismissed.
+ */
+export interface AiReviewTracker {
+  /** Mark a range's review as running (resets any prior state for that range). */
+  start(range: ChatRange): void;
+  /** Transition a running range → done, recording the persisted review id. */
+  finish(range: ChatRange, reviewId: number): void;
+  /** Transition a running range → failed, recording an error message. */
+  fail(range: ChatRange, error: string): void;
+  /** Remove a completed (done/failed) entry; running entries are kept. */
+  dismiss(range: ChatRange): void;
+  /** Snapshot of all tracked statuses. */
+  list(): AiReviewStatus[];
+}
+/** Map key for a range. */
+function key(range: ChatRange): string {
+  return `${range.start}:${range.end}`;
+}
+/** Create an {@link AiReviewTracker}. */
+export function createAiReviewTracker(): AiReviewTracker {
+  const statuses = new Map<string, AiReviewStatus>();
+  return {
+    start(range) {
+      statuses.set(key(range), {
+        startSha: range.start, endSha: range.end, state: "running", reviewId: null, error: null,
+      });
+    },
+    finish(range, reviewId) {
+      const cur = statuses.get(key(range));
+      if (!cur) return;
+      statuses.set(key(range), { ...cur, state: "done", reviewId, error: null });
+    },
+    fail(range, error) {
+      const cur = statuses.get(key(range));
+      if (!cur) return;
+      statuses.set(key(range), { ...cur, state: "failed", reviewId: null, error });
+    },
+    dismiss(range) {
+      const cur = statuses.get(key(range));
+      if (cur && cur.state !== "running") statuses.delete(key(range));
+    },
+    list: () => [...statuses.values()],
+  };
+}

package/src/daemon/allComments.ts ADDED Viewed

@@ -0,0 +1,119 @@
+import type { CommentRow, CommentSide } from "@/db/repositories/comments.ts";
+import type { GithubThread } from "./githubThreads.ts";
+/**
+ * Where a comment originates:
+ * - `'local'` — authored in mergie, not (yet) posted to GitHub.
+ * - `'posted'` — authored in mergie and posted to GitHub.
+ * - `'github'` — authored on GitHub (by anyone) and fetched into mergie.
+ */
+export type CommentOrigin = "local" | "posted" | "github";
+/**
+ * A single comment row for the unified "All comments" view, merged from the
+ * local comment store and the fetched GitHub inline-comment threads.
+ */
+export interface AllCommentEntry {
+  /** Stable unique key: `local:<id>` or `gh:<githubId>`. */
+  key: string;
+  /** Where the comment came from. */
+  origin: CommentOrigin;
+  /** True when authored by the current user. */
+  mine: boolean;
+  /** Display author: "You" when mine, else the GitHub login. */
+  author: string;
+  /** Repo-relative file path (null if GitHub omitted it). */
+  path: string | null;
+  /** Diff side the comment anchors to (null if unknown). */
+  side: CommentSide | null;
+  /** Human location string, e.g. "whole hunk", "line 5", "lines 5–8". */
+  location: string;
+  /** Markdown body. */
+  body: string;
+  /** Creation time (Unix ms); null if unknown. */
+  createdAt: number | null;
+  /** Number of replies (GitHub threads); 0 for local/posted without a thread. */
+  replyCount: number;
+  /** Local comment id for post/delete actions; null for github-origin entries. */
+  localId: number | null;
+  /** Head SHA when the comment was made (for the in-context link); null for github-origin. */
+  madeAtSha: string | null;
+  /** URL of the comment on GitHub if it exists there; null otherwise. */
+  githubUrl: string | null;
+  /** GitHub comment id when the comment lives on GitHub (posted or fetched); null for local drafts. */
+  githubId: string | null;
+}
+/** Human location string for a local comment. */
+function localLocation(c: CommentRow): string {
+  if (c.kind === "hunk") return "whole hunk";
+  if (c.startLine === null || c.endLine === null) return "lines ?";
+  return c.startLine === c.endLine ? `line ${c.startLine}` : `lines ${c.startLine}–${c.endLine}`;
+}
+/** Map a local comment row to a unified entry. */
+function fromLocal(c: CommentRow, replyCount: number): AllCommentEntry {
+  return {
+    key: `local:${c.id}`,
+    origin: c.githubId !== null ? "posted" : "local",
+    mine: true,
+    author: "You",
+    path: c.path,
+    side: c.side,
+    location: localLocation(c),
+    body: c.body,
+    createdAt: c.createdAt,
+    replyCount,
+    localId: c.id,
+    madeAtSha: c.madeAtSha,
+    githubUrl: c.githubUrl,
+    githubId: c.githubId,
+  };
+}
+/** Map an un-matched GitHub thread (not authored in mergie) to a unified entry. */
+function fromThread(t: GithubThread, viewer: string): AllCommentEntry {
+  const mine: boolean = viewer.length > 0 && t.root.author === viewer;
+  return {
+    key: `gh:${t.root.githubId}`,
+    origin: "github",
+    mine,
+    author: mine ? "You" : t.root.author,
+    path: t.path,
+    side: t.side,
+    location: t.line === null ? "line ?" : `line ${t.line}`,
+    body: t.root.body,
+    createdAt: t.root.createdAt,
+    replyCount: t.replies.length,
+    localId: null,
+    madeAtSha: null,
+    githubUrl: t.root.htmlUrl,
+    githubId: t.root.githubId,
+  };
+}
+/**
+ * Merge local comments and fetched GitHub threads into one unified list for the
+ * "All comments" view. A mergie comment that was posted to GitHub and then
+ * fetched back is shown once (as the local/posted entry, carrying its thread's
+ * reply count) — matching the diff view's de-duplication by GitHub id. Result
+ * is sorted newest-first by creation time.
+ *
+ * @param local   All locally-stored comments.
+ * @param threads Grouped, fetched GitHub inline-comment threads (roots+replies).
+ * @param viewer  The current user's GitHub login (empty string if unknown).
+ */
+export function mergeAllComments(local: CommentRow[], threads: GithubThread[], viewer: string): AllCommentEntry[] {
+  const threadByRootId = new Map<string, GithubThread>(threads.map((t) => [t.root.githubId, t]));
+  const postedIds = new Set<string>(local.map((c) => c.githubId).filter((id): id is string => id !== null));
+  const entries: AllCommentEntry[] = [
+    ...local.map((c) => fromLocal(c, c.githubId !== null ? (threadByRootId.get(c.githubId)?.replies.length ?? 0) : 0)),
+    ...threads.filter((t) => !postedIds.has(t.root.githubId)).map((t) => fromThread(t, viewer)),
+  ];
+  return entries
+    .map((e, i) => ({ e, i }))
+    .sort((a, b) => (b.e.createdAt ?? 0) - (a.e.createdAt ?? 0) || a.i - b.i)
+    .map(({ e }) => e);
+}

package/src/daemon/artifactCapture.ts ADDED Viewed

@@ -0,0 +1,47 @@
+import { existsSync, readdirSync } from "node:fs";
+import { join, relative } from "node:path";
+import type { ArtifactInput } from "@/db/repositories/artifacts.ts";
+/** List every file under `dir` recursively, as `/`-joined relative paths. */
+export function listRelFiles(dir: string): string[] {
+  if (!existsSync(dir)) return [];
+  const out: string[] = [];
+  const walk = (current: string): void => {
+    for (const entry of readdirSync(current, { withFileTypes: true })) {
+      const abs: string = join(current, entry.name);
+      if (entry.isDirectory()) walk(abs);
+      else if (entry.isFile()) out.push(relative(dir, abs));
+    }
+  };
+  walk(dir);
+  return out;
+}
+/** Fixed context for a batch of captured artifacts. */
+export interface CaptureContext {
+  /** Range baseline SHA the artifacts belong to. */
+  rangeStartSha: string;
+  /** Range end SHA the artifacts belong to. */
+  rangeEndSha: string;
+  /** The session that produced them. */
+  sessionId: number;
+  /** Creation timestamp (ms). */
+  now: number;
+}
+/**
+ * Compute the artifact rows for files that appeared in `dir` since the `before`
+ * snapshot of relative paths. The title defaults to the file's relative path.
+ */
+export function newArtifacts(dir: string, before: Set<string>, ctx: CaptureContext): ArtifactInput[] {
+  return listRelFiles(dir)
+    .filter((rel) => !before.has(rel))
+    .map((rel) => ({
+      rangeStartSha: ctx.rangeStartSha,
+      rangeEndSha: ctx.rangeEndSha,
+      sessionId: ctx.sessionId,
+      relPath: rel,
+      title: rel,
+      createdAt: ctx.now,
+    }));
+}

package/src/daemon/buildUi.ts ADDED Viewed

@@ -0,0 +1,54 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { bunRunner, type CommandRunner } from "@/services/exec.ts";
+/** Dependencies for building the web UI. */
+export interface BuildUiDeps {
+  /** Command runner to execute the build (defaults to the real Bun-backed runner). */
+  runner?: CommandRunner;
+  /** Checkout root holding `package.json` / `vite.config` — the build's cwd. */
+  root: string;
+  /** Progress/error sink (defaults to `console.error`). */
+  log?: (message: string) => void;
+  /**
+   * Whether the build toolchain (vite) is available under `root`. Defaults to
+   * probing `root/node_modules/.bin/vite`. Published installs ship a prebuilt UI
+   * and omit the toolchain, so this is `false` for them.
+   */
+  hasBuildTooling?: () => boolean;
+}
+/**
+ * Ensure the daemon has a web UI to serve. In a development checkout (the build
+ * toolchain is installed) this rebuilds the React UI (vite → `dist/web`) so the
+ * daemon serves the current interface on cold start. In a published install the
+ * toolchain is absent and a prebuilt `dist/web` ships in the package, so there is
+ * nothing to build — it serves the bundled UI as-is.
+ *
+ * Never throws: a failed build logs and resolves `false`, so the daemon still
+ * starts serving whatever build already exists (a stale UI beats no tool).
+ *
+ * @returns `true` if the UI is ready (freshly built or already bundled), `false`
+ *          if a build was attempted and failed.
+ */
+export async function buildWebUi(deps: BuildUiDeps): Promise<boolean> {
+  const runner: CommandRunner = deps.runner ?? bunRunner;
+  const log: (message: string) => void = deps.log ?? ((m) => console.error(m));
+  const hasBuildTooling: () => boolean =
+    deps.hasBuildTooling ?? (() => existsSync(join(deps.root, "node_modules", ".bin", "vite")));
+  // Published install: no toolchain to rebuild with; serve the bundled UI.
+  if (!hasBuildTooling()) {
+    log("mergie: serving prebuilt web UI.");
+    return true;
+  }
+  log("mergie: building web UI…");
+  const result = await runner.run("bun", ["run", "build:web"], { cwd: deps.root });
+  if (result.exitCode !== 0) {
+    log(`mergie: web UI build failed (exit ${result.exitCode}); serving the existing build.\n${result.stderr}`);
+    return false;
+  }
+  log("mergie: web UI build complete.");
+  return true;
+}

package/src/daemon/chatPrompt.ts ADDED Viewed

@@ -0,0 +1,35 @@
+import type { ChatRole } from "@/db/repositories/chatSessions.ts";
+/** Max length of a derived session title (including the trailing ellipsis). */
+const TITLE_CAP = 52;
+/**
+ * Derive a short session title from the first user prompt: whitespace is
+ * collapsed and the text is truncated to {@link TITLE_CAP} with an ellipsis.
+ * Falls back to "New chat" when the prompt is empty.
+ */
+export function sessionTitle(prompt: string): string {
+  const flat: string = prompt.replace(/\s+/g, " ").trim();
+  if (flat.length === 0) return "New chat";
+  return flat.length > TITLE_CAP ? `${flat.slice(0, TITLE_CAP - 1)}…` : flat;
+}
+/** A minimal chat message for transcript rendering. */
+export interface TranscriptMessage {
+  /** Who sent it. */
+  role: ChatRole;
+  /** Message content. */
+  content: string;
+}
+/**
+ * Render a session's messages into a single prompt for the agent. A first-turn
+ * (single user message) is passed through verbatim; multi-turn sessions become
+ * a `User:`/`Assistant:`-labelled transcript so the agent has prior context.
+ */
+export function chatTranscript(messages: TranscriptMessage[]): string {
+  if (messages.length === 1 && messages[0]?.role === "user") return messages[0].content;
+  return messages
+    .map((m) => `${m.role === "user" ? "User" : "Assistant"}: ${m.content}`)
+    .join("\n\n");
+}