birdclaw 0.8.2 → 0.8.4

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # CHANGELOG
 
+## 0.8.4 - 2026-06-19
+
+### Changed
+
+- Ship compiled CLI and production SSR/static artifacts, remove runtime TypeScript and Vite requirements, and validate installed npm tarballs end to end.
+- Normalize tweet ownership and saved state into account edges and collections, add transactional schema migrations, and preserve older databases and backups through boundary adapters.
+- Consolidate API schemas, NDJSON clients, React Query caches, profile codecs, moderation state, scheduled jobs, and live pagination while deleting superseded runtime paths.
+- Split archive import, portable backup codecs, and CLI command registration into domain-owned modules with shared contract tests.
+- Refresh runtime and development dependencies and resolve esbuild 0.28.1, clearing the active dependency advisory.
+- Rank link insights with a lightweight first pass and hydrate only the requested top groups, substantially reducing all-time Links latency.
+
+### Fixed
+
+- Preserve backup JSONL rows containing Unicode line or paragraph separators during export and import. (#62 - thanks @uwe-schwarz)
+- Derive unauthenticated local API access from the production server peer socket so spoofed host headers cannot bypass remote-access controls.
+- Normalize legacy stored media types at the API boundary so older archives and backups remain readable through typed response contracts.
+
+## 0.8.3 - 2026-06-15
+
+### Changed
+
+- Centralize SQLite writes and migrations, unify live-sync ingestion, and move retained web server state to TanStack Query for faster sidebar navigation and fewer duplicate reads.
+- Isolate web reads onto query-only SQLite connections while serializing action and sync writes through one measured writer queue.
+- Share page caps, cursor progression, delays, and repeated-cursor protection across live timeline, DM, and follow-graph sync.
+- Stream archive arrays and backup JSONL records through resumable batches instead of buffering entire source files.
+- Split query access into typed timeline, DM, status, resource, and action modules while retaining the existing compatibility import.
+- Retain Blocks, Inbox, Data Sources, and Rate Limits server state in TanStack Query across sidebar navigation and targeted refreshes.
+- Split compose, inbox, follow-graph, database, and backup CLI registration into domain-owned command modules.
+
+### Fixed
+
+- Preload hover-preview avatars after page load so citation and profile cards open with cached thumbnails.
+
 ## 0.8.2 - 2026-06-15
 
 ### Fixed

package/README.md

@@ -80,7 +80,7 @@ Status: WIP. Real and usable. Not done. Expect schema churn, transport gaps, and
 
 ### Runtime Architecture
 
-Birdclaw uses [Effect](https://effect.website/) for new and migrated I/O-heavy internals. The current Effect boundary covers browser API fetches, web sync orchestration, sync-job polling, `bird`/`xurl` subprocess helpers and public adapters, backup export/import/validation and Git orchestration, moderation action transport and target resolution, `bird` action/profile adapters, blocks/mutes write helpers, remote block sync, batch blocklist imports, x-web mutations, authored/mentions/mention-thread sync including xurl recent-search and parent-walk fallback internals, conversation loading, home timeline, saved collection, DM live sync, profile hydration/resolution/affiliation/reply inspection, shared tweet lookup, research and whois report generation, follow graph live sync, link preview/index fetches, archive discovery/import subprocesses, avatar/URL caches, OpenAI/inbox scoring, scheduled bookmark sync locking/audit/launchd install, and the paced/concurrent `media fetch` archive-reuse and HTTP download pipeline.
+Birdclaw uses [Effect](https://effect.website/) for new and migrated I/O-heavy internals. The current Effect boundary covers browser API fetches, web sync orchestration, sync-job polling, `bird`/`xurl` subprocess helpers and public adapters, backup export/import/validation and Git orchestration, moderation action transport and target resolution, `bird` action/profile adapters, blocks/mutes write helpers, remote block sync, batch blocklist imports, authored/mentions/mention-thread sync including xurl recent-search and parent-walk fallback internals, conversation loading, home timeline, saved collection, DM live sync, profile hydration/resolution/affiliation/reply inspection, shared tweet lookup, research and whois report generation, follow graph live sync, link preview/index fetches, archive discovery/import subprocesses, avatar/URL caches, OpenAI/inbox scoring, scheduled bookmark sync locking/audit/launchd install, and the paced/concurrent `media fetch` archive-reuse and HTTP download pipeline.
 
 Public CLI and React call sites still expose plain `Promise` wrappers where that keeps the surrounding framework code simple. New core code should prefer `Effect` programs with typed error values, then add a Promise wrapper only at the outer CLI, route, or component boundary.
 
@@ -267,15 +267,17 @@ Start the app:
 birdclaw serve
 ```
 
-`birdclaw serve` binds the dev server to `127.0.0.1` and enables local
-loopback web APIs without a token. Remote access through a trusted private proxy
-requires `BIRDCLAW_ALLOW_REMOTE_WEB=1`. To require an app-level token too, set
-`BIRDCLAW_WEB_TOKEN` and send it as `x-birdclaw-token` or a `birdclaw_token`
-cookie.
+`birdclaw serve` runs the built production app on `127.0.0.1:3000` and enables
+local loopback web APIs without a token. Override the listener with `--host` and
+`--port`, or `BIRDCLAW_HOST` and `BIRDCLAW_PORT`. Remote access through a trusted
+private proxy requires `BIRDCLAW_ALLOW_REMOTE_WEB=1`. To require an app-level
+token too, set `BIRDCLAW_WEB_TOKEN` and send it as `x-birdclaw-token` or a
+`birdclaw_token` cookie.
 
 Use the Sync button in Home, Mentions, Likes, Bookmarks, or DMs to run the matching live sync from the web UI and then reload the local view. These controls are explicit because live reads can be slow, auth-dependent, or rate-limited.
 
-When running behind a trusted reverse proxy such as Tailscale Serve, add any extra proxy hostnames to `BIRDCLAW_ALLOWED_HOSTS`. The clawmac Tailscale hostname is allowed by default.
+`BIRDCLAW_ALLOWED_HOSTS` applies only to the source `pnpm dev` server, not the
+built server started by `birdclaw serve`.
 
 First moderation pass:
 
@@ -490,7 +492,7 @@ pnpm cli unban @amelia --account acct_primary --transport bird --json
 Notes:
 
 - `ban` / `unban` accept `--transport auto|bird|xurl`
-- `auto` tries `bird` first, then falls back to `xurl`; unverified x-web writes are not used by moderation actions
+- `auto` tries `bird` first, then falls back to verified `xurl`
 - forced `xurl` writes still verify through `bird status` before sqlite changes
 - Twitter still rejects pure OAuth2 block writes, so `auto` is the safe default for block/unblock
 - `blocks import` accepts newline-delimited blocklists with comments and markdown bullets

package/bin/birdclaw.mjs

@@ -1,69 +1,7 @@
 #!/usr/bin/env node
-import { spawn } from "node:child_process";
-import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
+import { runCli } from "../dist/cli/birdclaw.js";
 
-const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
-const require = createRequire(import.meta.url);
-const tsxLoader = pathToFileURL(require.resolve("tsx")).href;
-const birdclawCli = join(packageRoot, "src", "cli.ts");
-
-const child = spawn(
-	process.execPath,
-	["--import", tsxLoader, birdclawCli, ...process.argv.slice(2)],
-	{
-		stdio: "inherit",
-		env: process.env,
-		detached: process.platform !== "win32",
-	},
-);
-
-const forwardedSignals = ["SIGINT", "SIGTERM", "SIGHUP", "SIGQUIT"];
-
-function removeSignalHandlers() {
-	for (const signal of forwardedSignals) {
-		process.removeListener(signal, forwardSignal);
-	}
-}
-
-function forwardSignal(signal) {
-	if (child.exitCode === null && child.signalCode === null) {
-		signalChild(signal);
-	}
-}
-
-function signalChild(signal) {
-	if (child.pid === undefined) {
-		return;
-	}
-	const targetPid = process.platform === "win32" ? child.pid : -child.pid;
-	try {
-		process.kill(targetPid, signal);
-	} catch (error) {
-		if (error?.code !== "ESRCH") {
-			throw error;
-		}
-	}
-}
-
-for (const signal of forwardedSignals) {
-	process.on(signal, forwardSignal);
-}
-
-child.on("error", (error) => {
-	removeSignalHandlers();
-	console.error(error.message);
-	process.exit(1);
-});
-
-child.on("exit", (code, signal) => {
-	removeSignalHandlers();
-
-	if (signal) {
-		process.kill(process.pid, signal);
-		return;
-	}
-
-	process.exit(code ?? 0);
+void runCli().catch((error) => {
+	console.error(error instanceof Error ? error.message : String(error));
+	process.exitCode = 1;
 });