birdclaw 0.8.1 → 0.8.3

package/src/cli/register-graph.ts

@@ -0,0 +1,132 @@
+import {
+	getFollowGraphSummary,
+	listFollowEvents,
+	listMutuals,
+	listNonMutualFollowing,
+	listTopFollowers,
+	listUnfollowedSince,
+} from "#/lib/follow-graph";
+import type { CliCommandContext } from "./command-context";
+
+export function registerGraphCommands({
+	program,
+	print,
+	autoUpdateBeforeRead,
+}: CliCommandContext) {
+	const graphCommand = program
+		.command("graph")
+		.description("Query the local cache-only follow graph");
+
+	graphCommand
+		.command("summary")
+		.description(
+			"Summarize cached followers, following, mutuals, and snapshots",
+		)
+		.option("--account <accountId>", "Account id")
+		.action(async (options) => {
+			await autoUpdateBeforeRead();
+			print(getFollowGraphSummary({ account: options.account }), true);
+		});
+
+	graphCommand
+		.command("top-followers")
+		.description("List current followers sorted by their follower count")
+		.option("--account <accountId>", "Account id")
+		.option("--limit <n>", "Limit results", "20")
+		.action(async (options) => {
+			await autoUpdateBeforeRead();
+			print(
+				listTopFollowers({
+					account: options.account,
+					limit: Number(options.limit),
+				}),
+				true,
+			);
+		});
+
+	graphCommand
+		.command("unfollowed")
+		.description("List cached ended follow edges since a date")
+		.requiredOption("--date <date>", "YYYY-MM-DD or ISO timestamp")
+		.option("--account <accountId>", "Account id")
+		.option("--direction <direction>", "followers or following", "followers")
+		.option("--limit <n>", "Limit results", "100")
+		.action(async (options) => {
+			await autoUpdateBeforeRead();
+			print(
+				listUnfollowedSince({
+					account: options.account,
+					date: options.date,
+					direction:
+						options.direction === "following" ? "following" : "followers",
+					limit: Number(options.limit),
+				}),
+				true,
+			);
+		});
+
+	graphCommand
+		.command("events")
+		.description("List cached append-only follow graph events")
+		.option("--account <accountId>", "Account id")
+		.option("--direction <direction>", "followers or following")
+		.option("--kind <kind>", "started or ended")
+		.option("--since <date>", "YYYY-MM-DD or ISO timestamp")
+		.option("--until <date>", "YYYY-MM-DD or ISO timestamp")
+		.option("--limit <n>", "Limit results", "100")
+		.action(async (options) => {
+			await autoUpdateBeforeRead();
+			print(
+				listFollowEvents({
+					account: options.account,
+					direction:
+						options.direction === "followers" ||
+						options.direction === "following"
+							? options.direction
+							: undefined,
+					kind:
+						options.kind === "started" || options.kind === "ended"
+							? options.kind
+							: undefined,
+					since: options.since,
+					until: options.until,
+					limit: Number(options.limit),
+				}),
+				true,
+			);
+		});
+
+	graphCommand
+		.command("non-mutual-following")
+		.description("List current following who are not current followers")
+		.option("--account <accountId>", "Account id")
+		.option("--sort <mode>", "followers or handle", "followers")
+		.option("--limit <n>", "Limit results", "100")
+		.action(async (options) => {
+			await autoUpdateBeforeRead();
+			print(
+				listNonMutualFollowing({
+					account: options.account,
+					sort: options.sort === "handle" ? "handle" : "followers",
+					limit: Number(options.limit),
+				}),
+				true,
+			);
+		});
+
+	graphCommand
+		.command("mutuals")
+		.description("List profiles that are both followers and following")
+		.option("--account <accountId>", "Account id")
+		.option("--limit <n>", "Limit results", "100")
+		.action(async (options) => {
+			await autoUpdateBeforeRead();
+			print(
+				listMutuals({
+					account: options.account,
+					limit: Number(options.limit),
+				}),
+				true,
+			);
+		});
+}

package/src/cli/register-inbox.ts

@@ -0,0 +1,41 @@
+import { listInboxItems, scoreInbox } from "#/lib/inbox";
+import type { CliCommandContext } from "./command-context";
+
+export function registerInboxCommand({
+	program,
+	print,
+	asJson,
+	autoSyncAfterWrite,
+	autoUpdateBeforeRead,
+}: CliCommandContext) {
+	program
+		.command("inbox")
+		.option("--kind <kind>", "mixed, mentions, or dms", "mixed")
+		.option("--min-score <n>", "Minimum rank", "0")
+		.option("--hide-low-signal", "Hide low-signal items")
+		.option("--score", "Score top items with OpenAI before listing")
+		.option("--limit <n>", "Limit results", "20")
+		.action(async (options) => {
+			await autoUpdateBeforeRead();
+			const kind =
+				options.kind === "mentions" || options.kind === "dms"
+					? options.kind
+					: "mixed";
+			if (options.score) {
+				await scoreInbox({
+					kind,
+					limit: Number(options.limit),
+				});
+				await autoSyncAfterWrite();
+			}
+			print(
+				listInboxItems({
+					kind,
+					minScore: Number(options.minScore),
+					hideLowSignal: Boolean(options.hideLowSignal),
+					limit: Number(options.limit),
+				}),
+				asJson(),
+			);
+		});
+}

package/src/cli/register-storage.ts

@@ -0,0 +1,106 @@
+import {
+	exportBackup,
+	importBackup,
+	syncBackup,
+	validateBackup,
+} from "#/lib/backup";
+import { getBirdclawPaths } from "#/lib/config";
+import { getDatabaseRuntimeMetrics } from "#/lib/database-metrics";
+import { getQueryEnvelope } from "#/lib/queries";
+import type { CliCommandContext } from "./command-context";
+
+export function registerStorageCommands({
+	program,
+	print,
+	asJson,
+	autoUpdateBeforeRead,
+}: CliCommandContext) {
+	program
+		.command("db stats")
+		.description("Show local storage and dataset stats")
+		.action(async () => {
+			await autoUpdateBeforeRead();
+			const meta = await getQueryEnvelope();
+			const paths = getBirdclawPaths();
+			print(
+				{
+					paths,
+					database: getDatabaseRuntimeMetrics(),
+					stats: meta.stats,
+					transport: meta.transport,
+				},
+				asJson(),
+			);
+		});
+
+	const backupCommand = program
+		.command("backup")
+		.description("Export, import, and validate Git-friendly text backups");
+
+	backupCommand
+		.command("export")
+		.description("Export canonical JSONL backup shards")
+		.requiredOption("--repo <path>", "Backup repository/path")
+		.option("--commit", "Create a git commit in the backup repo")
+		.option("--push", "Push the backup repo after committing")
+		.option(
+			"--message <message>",
+			"Git commit message",
+			"archive: update birdclaw backup",
+		)
+		.option("--no-validate", "Skip post-export validation")
+		.action(async (options) => {
+			const result = await exportBackup({
+				repoPath: options.repo,
+				commit: Boolean(options.commit) || Boolean(options.push),
+				push: Boolean(options.push),
+				message: options.message,
+				validate: options.validate,
+			});
+			print(result, true);
+		});
+
+	backupCommand
+		.command("import <repo>")
+		.description("Merge a canonical JSONL backup into the local SQLite store")
+		.option("--no-validate", "Skip backup validation before import")
+		.option("--replace", "Replace local portable tables instead of merging")
+		.action(async (repo, options) => {
+			const result = await importBackup({
+				repoPath: repo,
+				validate: options.validate,
+				mode: options.replace ? "replace" : "merge",
+			});
+			print(result, true);
+		});
+
+	backupCommand
+		.command("sync")
+		.description("Pull, merge-import, export, commit, and push a backup repo")
+		.requiredOption("--repo <path>", "Backup repository/path")
+		.option("--remote <url>", "Git remote to clone/configure")
+		.option(
+			"--message <message>",
+			"Git commit message",
+			"archive: sync birdclaw backup",
+		)
+		.action(async (options) => {
+			const result = await syncBackup({
+				repoPath: options.repo,
+				remote: options.remote,
+				message: options.message,
+			});
+			print(result, true);
+		});
+
+	backupCommand
+		.command("validate <repo>")
+		.description("Validate backup manifest, shard hashes, and JSONL rows")
+		.action(async (repo) => {
+			const result = await validateBackup(repo);
+			print(result, true);
+			if (!result.ok) {
+				process.exitCode = 1;
+			}
+		});
+}