@usesocial/cli 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @usesocial/cli
 
+## 0.10.0
+
+### Minor Changes
+
+- [#38](https://github.com/usesocial/monorepo/pull/38) [`9f1f30d`](https://github.com/usesocial/monorepo/commit/9f1f30daeb89b5ad83bcc456a0ed71a5587e790c) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Add `social x sync timeline` for syncing the authenticated X home timeline into the local SQL mirror, remove the live `social x timeline` shortcut from the public command surface, and let local SQL reads query partial mirror rows.
+
 ## 0.9.0
 
 ### Minor Changes

package/README.md

@@ -48,7 +48,7 @@ social x profile
 | "Surface the ten warm contacts worth reaching out to this week." | `linkedin search people`, `linkedin reactions`, `linkedin sql` |
 | "Pull everyone who reacted to my last LinkedIn post and flag the warm leads." | `linkedin posts <target>`, `linkedin reactions`, `linkedin profile` |
 | "Read this creator's recent posts and break down what makes them land." | `linkedin posts <target>`, `x tweets <target>` |
-| "Find what people are saying about AI agents this week and summarize the themes." | `linkedin search posts`, `x timeline` |
+| "Find what people are saying about AI agents this week and summarize the themes." | `linkedin search posts`, `x sync timeline`, `x sql` |
 | "Triage my inbox and draft replies for approval." | `sync messages`, `sql`, `linkedin message`, `x message` |
 | "Draft a reply to this thread and post it once I approve." | `linkedin comment`, `x post` |
 
@@ -161,7 +161,7 @@ profile lookup is needed.
 | `jobs <target>` | List a company's job postings. | |
 | `search people\|posts\|jobs\|companies <keywords>` | Search LinkedIn. | |
 | `sync [collection]` | Pull your own `connections`, `posts`, `messages`, or `requests` into the local mirror; costs credits. | local |
-| `sql [query]` | Query your synced local mirror with read-only SQL - free; bare `sql` prints compact schema metadata. | |
+| `sql [query]` | Query your local mirror with read-only SQL - free; bare `sql` prints compact schema metadata. | |
 | `post` | Create a post (body from stdin). | write |
 | `comment <target>` | Comment on a post (body from stdin). | write |
 | `react <target>` | React to a post; use `--type` for non-like reactions. | write |
@@ -180,7 +180,6 @@ profile lookup is needed.
 | --- | --- | --- |
 | `profile [target]` | Fetch a profile; omit target for your own account. | |
 | `tweets <target>` | Live posts for a user; target required. | |
-| `timeline` | Read the home timeline. | |
 | `mentions [target]` | List posts mentioning a user; omit target for your own account. | |
 | `liked [target]` | List posts a user liked; omit target for your own account. | |
 | `followers [target]` | Live follower graph read; omit target for your own account. Costs credits. | |
@@ -190,8 +189,8 @@ profile lookup is needed.
 | `quotes <target>` | List quote posts of a post. | |
 | `likers <target>` | List users who liked a post. | |
 | `reposters <target>` | List users who reposted a post. | |
-| `sync [collection]` | Pull your own `tweets`, `followers`, `following`, `bookmarks`, or `messages` into the local mirror; costs credits. | local |
-| `sql [query]` | Query your synced local mirror with read-only SQL - free; bare `sql` prints compact schema metadata. | |
+| `sync [collection]` | Pull your own `tweets`, `timeline`, `followers`, `following`, `bookmarks`, `liked`, `mentions`, or `messages` into the local mirror; costs credits. | local |
+| `sql [query]` | Query your local mirror with read-only SQL - free; bare `sql` prints compact schema metadata. | |
 | `post` | Create a post (body from stdin). | write |
 | `message <recipients>` | Send a DM (body from stdin). | write |
 | `like <target>` / `unlike <target>` | Like or unlike a post. | write |
@@ -276,7 +275,9 @@ query it with `sql`. SQL reads show local freshness in `meta.cache.tables` and a
 ```sh
 social x sql "SELECT sender_username, text FROM x_messages ORDER BY created_at DESC LIMIT 5" \
   | jq '{cost: .meta.cost, cache: .meta.cache}'
-social x timeline --limit 20 | jq '{cost: .meta.cost, cursor: .meta.cursor, cache: .meta.cache}'
+social x sync timeline
+social x sql "SELECT text, url FROM x_timeline ORDER BY created_at DESC LIMIT 20" \
+  | jq '{cost: .meta.cost, cache: .meta.cache}'
 ```
 
 Agents should watch `.meta.cost` during high-fanout loops, use
@@ -303,11 +304,12 @@ social x sync messages
 social x sql "SELECT sender_username, text FROM x_messages ORDER BY created_at DESC LIMIT 20"
 social x sql "SELECT text, url FROM x_bookmarks ORDER BY created_at DESC LIMIT 50"
 social x sql "SELECT username, name, followers_count FROM x_followers ORDER BY followers_count DESC LIMIT 100"
+social x sync timeline
+social x sql "SELECT text, url FROM x_timeline ORDER BY created_at DESC LIMIT 50"
 
 # X live reads.
 social x tweets profile_id:<x-user-id> --limit 30
 social x replies post_id:<post-id> --limit 25
-social x timeline --limit 50
 
 # Writes (body via stdin).
 echo "gm" | social x post

package/dist/index.mjs

@@ -752,7 +752,7 @@ const defineRuntimeOperationCommand = (adapter, op, deps) => {
 	});
 };
 //#endregion
-//#region ../../packages/sync-engine/src/collections/linkedin.ts
+//#region ../../packages/sqlsync/src/collections/linkedin.ts
 const linkedinCursorPagination = {
 	style: "cursor",
 	limitParam: "limit",
@@ -1072,7 +1072,7 @@ const LINKEDIN_CACHE_METADATA = {
 	}
 };
 //#endregion
-//#region ../../packages/sync-engine/src/collections/x.ts
+//#region ../../packages/sqlsync/src/collections/x.ts
 const xPagination = {
 	style: "cursor",
 	limitParam: "max_results",
@@ -1216,6 +1216,21 @@ const X_COLLECTIONS = [
 		expectedFields: expectedTweetFields,
 		lift: liftTweet
 	},
+	{
+		key: "x_timeline",
+		table: "x_timeline_raw",
+		platform: "x",
+		requests: [{
+			path: "/users/:id/timelines/reverse_chronological",
+			bakedQuery: defaultTweetBakedQuery
+		}],
+		ownIdToken: ":id",
+		pagination: xPagination,
+		pageSize: 100,
+		sinceField: "created_at",
+		expectedFields: expectedTweetFields,
+		lift: liftTweet
+	},
 	{
 		key: "x_followers",
 		table: "x_followers_raw",
@@ -1313,7 +1328,8 @@ const X_CACHE_METADATA = {
 		"x_messages.sender_id = x_profiles.provider_id",
 		"x_messages.counterpart_id = x_profiles.provider_id",
 		"x_conversation_participants.participant_id = x_profiles.provider_id",
-		"x_followers.id = x_profiles.provider_id"
+		"x_followers.id = x_profiles.provider_id",
+		"x_timeline.author_id = x_profiles.provider_id"
 	],
 	enums: {
 		"x_followers.verified_type": [
@@ -1364,6 +1380,11 @@ const X_CACHE_METADATA = {
 			"sender_id"
 		],
 		x_profiles: ["username"],
+		x_timeline: [
+			"created_at",
+			"author_id",
+			"conversation_id"
+		],
 		x_tweets: [
 			"created_at",
 			"author_id",
@@ -1372,7 +1393,7 @@ const X_CACHE_METADATA = {
 	}
 };
 //#endregion
-//#region ../../packages/sync-engine/src/collections/index.ts
+//#region ../../packages/sqlsync/src/collections/index.ts
 const COLLECTIONS = [...X_COLLECTIONS, ...LINKEDIN_COLLECTIONS];
 const CACHE_METADATA_BY_PLATFORM = {
 	linkedin: LINKEDIN_CACHE_METADATA,
@@ -1392,7 +1413,7 @@ const resetTablesFor = (collection) => {
 };
 const resetPhysicalTablesFor = (collection) => resetTablesFor(collection).map(physicalTableFor);
 //#endregion
-//#region ../../packages/sync-engine/src/migrations.generated.ts
+//#region ../../packages/sqlsync/src/migrations.generated.ts
 const MIGRATIONS = [
 	{
 		"tag": "0000_modern_stephen_strange",
@@ -1433,10 +1454,14 @@ const MIGRATIONS = [
 	{
 		"tag": "0009_x_liked_mentions",
 		"sql": "CREATE TABLE \"x_liked_raw\" (\n  \"id\" text PRIMARY KEY NOT NULL,\n  \"created_at\" integer,\n  \"author_id\" text,\n  \"conversation_id\" text,\n  \"in_reply_to_user_id\" text,\n  \"lang\" text,\n  \"reply_settings\" text,\n  \"text\" text,\n  \"url\" text,\n  \"paid_partnership\" integer,\n  \"possibly_sensitive\" integer,\n  \"like_count\" integer,\n  \"retweet_count\" integer,\n  \"reply_count\" integer,\n  \"quote_count\" integer,\n  \"bookmark_count\" integer,\n  \"impression_count\" integer,\n  \"raw\" text NOT NULL,\n  \"synced_at\" integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX \"x_liked_created_at_idx\" ON \"x_liked_raw\" (\"created_at\");--> statement-breakpoint\nCREATE INDEX \"x_liked_author_id_created_at_idx\" ON \"x_liked_raw\" (\"author_id\",\"created_at\");--> statement-breakpoint\nCREATE INDEX \"x_liked_conversation_id_created_at_idx\" ON \"x_liked_raw\" (\"conversation_id\",\"created_at\");--> statement-breakpoint\nCREATE VIEW \"x_liked\" AS\nSELECT \"id\", \"created_at\", \"author_id\", \"conversation_id\", \"in_reply_to_user_id\", \"lang\",\n       \"reply_settings\", \"text\", \"url\", \"paid_partnership\", \"possibly_sensitive\",\n       \"like_count\", \"retweet_count\", \"reply_count\", \"quote_count\", \"bookmark_count\",\n       \"impression_count\"\nFROM \"x_liked_raw\";\n--> statement-breakpoint\nCREATE TABLE \"x_mentions_raw\" (\n  \"id\" text PRIMARY KEY NOT NULL,\n  \"created_at\" integer,\n  \"author_id\" text,\n  \"conversation_id\" text,\n  \"in_reply_to_user_id\" text,\n  \"lang\" text,\n  \"reply_settings\" text,\n  \"text\" text,\n  \"url\" text,\n  \"paid_partnership\" integer,\n  \"possibly_sensitive\" integer,\n  \"like_count\" integer,\n  \"retweet_count\" integer,\n  \"reply_count\" integer,\n  \"quote_count\" integer,\n  \"bookmark_count\" integer,\n  \"impression_count\" integer,\n  \"raw\" text NOT NULL,\n  \"synced_at\" integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX \"x_mentions_created_at_idx\" ON \"x_mentions_raw\" (\"created_at\");--> statement-breakpoint\nCREATE INDEX \"x_mentions_author_id_created_at_idx\" ON \"x_mentions_raw\" (\"author_id\",\"created_at\");--> statement-breakpoint\nCREATE INDEX \"x_mentions_conversation_id_created_at_idx\" ON \"x_mentions_raw\" (\"conversation_id\",\"created_at\");--> statement-breakpoint\nCREATE VIEW \"x_mentions\" AS\nSELECT \"id\", \"created_at\", \"author_id\", \"conversation_id\", \"in_reply_to_user_id\", \"lang\",\n       \"reply_settings\", \"text\", \"url\", \"paid_partnership\", \"possibly_sensitive\",\n       \"like_count\", \"retweet_count\", \"reply_count\", \"quote_count\", \"bookmark_count\",\n       \"impression_count\"\nFROM \"x_mentions_raw\";\n"
+	},
+	{
+		"tag": "0010_x_timeline",
+		"sql": "CREATE TABLE \"x_timeline_raw\" (\n  \"id\" text PRIMARY KEY NOT NULL,\n  \"created_at\" integer,\n  \"author_id\" text,\n  \"conversation_id\" text,\n  \"in_reply_to_user_id\" text,\n  \"lang\" text,\n  \"reply_settings\" text,\n  \"text\" text,\n  \"url\" text,\n  \"paid_partnership\" integer,\n  \"possibly_sensitive\" integer,\n  \"like_count\" integer,\n  \"retweet_count\" integer,\n  \"reply_count\" integer,\n  \"quote_count\" integer,\n  \"bookmark_count\" integer,\n  \"impression_count\" integer,\n  \"raw\" text NOT NULL,\n  \"synced_at\" integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX \"x_timeline_created_at_idx\" ON \"x_timeline_raw\" (\"created_at\");--> statement-breakpoint\nCREATE INDEX \"x_timeline_author_id_created_at_idx\" ON \"x_timeline_raw\" (\"author_id\",\"created_at\");--> statement-breakpoint\nCREATE INDEX \"x_timeline_conversation_id_created_at_idx\" ON \"x_timeline_raw\" (\"conversation_id\",\"created_at\");--> statement-breakpoint\nCREATE VIEW \"x_timeline\" AS\nSELECT \"id\", \"created_at\", \"author_id\", \"conversation_id\", \"in_reply_to_user_id\", \"lang\",\n       \"reply_settings\", \"text\", \"url\", \"paid_partnership\", \"possibly_sensitive\",\n       \"like_count\", \"retweet_count\", \"reply_count\", \"quote_count\", \"bookmark_count\",\n       \"impression_count\"\nFROM \"x_timeline_raw\";\n"
 	}
 ];
 //#endregion
-//#region ../../packages/sync-engine/src/migrate.ts
+//#region ../../packages/sqlsync/src/migrate.ts
 const readUserVersion = (db) => {
 	const version = db.prepare("PRAGMA user_version").get()?.user_version;
 	return typeof version === "number" ? version : Number(version ?? 0);
@@ -1470,7 +1495,7 @@ const assertAtLatest = (db) => {
 	if (currentVersion < MIGRATIONS.length) throw new Error(`Local SQLite cache schema is at version ${currentVersion}; expected ${MIGRATIONS.length}`);
 };
 //#endregion
-//#region ../../packages/sync-engine/src/sqlite.ts
+//#region ../../packages/sqlsync/src/sqlite.ts
 const loadModule = createRequire(import.meta.url);
 const isBunRuntime = () => typeof Bun !== "undefined";
 const normalizeValue = (value) => {
@@ -1526,7 +1551,7 @@ const openDatabase = (path, opts) => {
 	};
 };
 //#endregion
-//#region ../../packages/sync-engine/src/write-through.ts
+//#region ../../packages/sqlsync/src/write-through.ts
 const quoteIdentifier$3 = (identifier) => `\`${identifier.replaceAll("`", "``")}\``;
 const collectionForTable = (table) => table.endsWith("_raw") ? table.slice(0, -4) : table;
 const profileTables$1 = new Set(["x_profiles_raw", "li_profiles_raw"]);
@@ -1574,17 +1599,10 @@ const applyWriteThrough = (db, args) => {
 	};
 };
 //#endregion
-//#region ../../packages/sync-engine/src/cache.ts
-var NeverSyncedError = class extends Error {
-	name = "NeverSyncedError";
-	tables;
-	constructor(tables, message) {
-		super(message);
-		this.tables = tables;
-	}
-};
+//#region ../../packages/sqlsync/src/cache.ts
 const publicCacheTables = [
 	"x_tweets",
+	"x_timeline",
 	"x_followers",
 	"x_following",
 	"x_bookmarks",
@@ -1614,6 +1632,7 @@ const sanitizeAccountId = (accountId) => accountId.replaceAll(/[^A-Za-z0-9._-]/g
 const quoteIdentifier$2 = (identifier) => `\`${identifier.replaceAll("`", "``")}\``;
 const resolveCachePath = (path) => path === ":memory:" ? path : resolve(path);
 const rawTableFor = (table) => table === "sync_state" ? table : `${table}_raw`;
+const partialSyncCursorPrefix = "partial-sync-v1:";
 const collectionForReadTable = (table) => table.endsWith("_raw") ? table.slice(0, -4) : table;
 const physicalTableForCacheTable = (table) => table === "sync_state" || table.endsWith("_raw") ? table : rawTableFor(table);
 const stringOrNull = (value) => typeof value === "string" ? value : null;
@@ -1644,7 +1663,6 @@ const referencedTablesForRead = (sql, platform) => {
 	const allowedTables = platformTables[platform];
 	return knownTableTokens(sql).filter((table) => allowedTables.has(table));
 };
-const collectionShortName = (collection) => collection.replace(/^(x|li)_/, "");
 const tableFreshnessPolicies = {
 	x_conversation_participants: {
 		kind: "collection",
@@ -1656,13 +1674,11 @@ const tableFreshnessPolicies = {
 	},
 	li_conversations: {
 		kind: "collection",
-		collection: "li_conversations",
-		commandCollection: "li_messages"
+		collection: "li_conversations"
 	},
 	li_conversations_raw: {
 		kind: "collection",
-		collection: "li_conversations",
-		commandCollection: "li_messages"
+		collection: "li_conversations"
 	},
 	li_profiles: {
 		kind: "platform",
@@ -1686,44 +1702,25 @@ const freshnessPolicyForTable = (table) => tableFreshnessPolicies[table] ?? {
 	collection: collectionForReadTable(table)
 };
 const platformCollectionPrefix = (platform) => platform === "linkedin" ? "li_" : "x_";
-const syncCommandForPolicy = (platform, policy) => {
-	if (policy.kind === "platform") return `social ${policy.platform} sync`;
-	return `social ${platform} sync ${collectionShortName(policy.commandCollection ?? policy.collection)}`;
-};
-const missingNameForPolicy = (table, policy) => policy.kind === "platform" ? table : policy.collection;
-const formatList = (items) => {
-	if (items.length <= 1) return items[0] ?? "";
-	if (items.length === 2) return `${items[0]} and ${items[1]}`;
-	return `${items.slice(0, -1).join(", ")}, and ${items.at(-1)}`;
+const partialCollectionLastSynced = (db, collection, cursor) => {
+	if (typeof cursor !== "string" || !cursor.startsWith(partialSyncCursorPrefix)) return null;
+	if (!cacheTables.has(collection)) return null;
+	return numberOrNull(db.prepare(`SELECT MAX(synced_at) AS last_synced FROM ${quoteIdentifier$2(rawTableFor(collection))}`).get()?.last_synced);
 };
 const collectionLastSynced = (db, collection) => {
-	return numberOrNull(db.prepare("SELECT last_synced FROM sync_state WHERE collection = :collection").get({ collection })?.last_synced);
+	const syncState = db.prepare("SELECT cursor, last_synced FROM sync_state WHERE collection = :collection").get({ collection });
+	return numberOrNull(syncState?.last_synced) ?? partialCollectionLastSynced(db, collection, syncState?.cursor);
 };
 const platformLastSynced = (db, platform) => {
-	return numberOrNull(db.prepare("SELECT MAX(last_synced) AS last_synced FROM sync_state WHERE collection GLOB :glob").get({ glob: `${platformCollectionPrefix(platform)}*` })?.last_synced);
+	const syncState = db.prepare("SELECT MAX(last_synced) AS last_synced FROM sync_state WHERE collection GLOB :glob").get({ glob: `${platformCollectionPrefix(platform)}*` });
+	const partialRows = db.prepare("SELECT collection, cursor FROM sync_state WHERE collection GLOB :glob AND last_synced IS NULL AND cursor LIKE :partial").all({
+		glob: `${platformCollectionPrefix(platform)}*`,
+		partial: `${partialSyncCursorPrefix}%`
+	});
+	const timestamps = [numberOrNull(syncState?.last_synced), ...partialRows.map((row) => partialCollectionLastSynced(db, String(row.collection), row.cursor))].filter((value) => value !== null);
+	return timestamps.length === 0 ? null : Math.max(...timestamps);
 };
 const lastSyncedForPolicy = (db, policy) => policy.kind === "platform" ? platformLastSynced(db, policy.platform) : collectionLastSynced(db, policy.collection);
-const missingFreshnessForTables = (tables) => {
-	const missing = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const table of tables) {
-		if (table.lastSynced != null) continue;
-		const key = `${table.missingName}\0${table.command}`;
-		if (!seen.has(key)) {
-			seen.add(key);
-			missing.push({
-				name: table.missingName,
-				command: table.command
-			});
-		}
-	}
-	return missing;
-};
-const neverSyncedMessage = (missing) => {
-	const names = missing.map((item) => item.name);
-	const commands = missing.map((item) => `\`${item.command}\``);
-	return `No synced ${formatList(names)} yet — run ${formatList(commands)} first.`;
-};
 const assertKnownProfileTable = (table) => {
 	assertKnownTable(table);
 	if (!profileTables.has(physicalTableForCacheTable(table))) throw new Error(`Unknown profile table: ${table}`);
@@ -1817,7 +1814,7 @@ const createCache = (path, db) => ({
 		if (!row) return;
 		return {
 			cursor: stringOrNull(row.cursor),
-			lastSynced: numberOrNull(row.last_synced),
+			lastSynced: numberOrNull(row.last_synced) ?? partialCollectionLastSynced(db, collection, row.cursor),
 			objectCount: numberOrNull(row.object_count)
 		};
 	},
@@ -1853,22 +1850,14 @@ const createCache = (path, db) => ({
 	read: (sql, opts) => {
 		assertPlatformQuery(sql, opts.platform);
 		const tables = referencedTablesForRead(sql, opts.platform).map((name) => {
-			const policy = freshnessPolicyForTable(name);
 			return {
 				name,
-				missingName: missingNameForPolicy(name, policy),
-				command: syncCommandForPolicy(opts.platform, policy),
-				lastSynced: lastSyncedForPolicy(db, policy)
+				lastSynced: lastSyncedForPolicy(db, freshnessPolicyForTable(name))
 			};
 		});
-		const missingFreshness = missingFreshnessForTables(tables);
-		if (missingFreshness.length > 0) throw new NeverSyncedError(missingFreshness.map((item) => item.name), neverSyncedMessage(missingFreshness));
 		return {
 			rows: db.prepare(sql).all(),
-			tables: tables.map(({ name, lastSynced }) => ({
-				name,
-				lastSynced
-			}))
+			tables
 		};
 	},
 	describe: (opts) => {
@@ -1893,7 +1882,6 @@ const createCache = (path, db) => ({
 					name,
 					rows: Number(rowCount?.rows ?? 0),
 					synced_at: syncedAt,
-					query_ready: syncedAt != null,
 					columns: columnsForTable(name),
 					indexed: metadata.indexed[name] ?? []
 				};
@@ -1905,7 +1893,7 @@ const createCache = (path, db) => ({
 	}
 });
 //#endregion
-//#region ../../packages/sync-engine/src/since.ts
+//#region ../../packages/sqlsync/src/since.ts
 const isoDatePattern = /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/;
 const isoDateTimePattern = /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])T([01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d{1,3})?)?(?:Z|[+-]([01]\d|2[0-3]):[0-5]\d)?$/;
 const timezonePattern = /(Z|[+-]\d{2}:\d{2})$/;
@@ -6499,17 +6487,17 @@ function superRefine(fn, params) {
 	return /* @__PURE__ */ _superRefine(fn, params);
 }
 //#endregion
-//#region ../../packages/sync-engine/src/cost.ts
+//#region ../../packages/sqlsync/src/cost.ts
 const creditsFromHeader = (headers) => {
 	const rawCredits = headers?.get("social-x-credits-used");
 	const credits = rawCredits == null ? NaN : Number.parseInt(rawCredits, 10);
 	return Number.isNaN(credits) || credits < 0 ? 0 : credits;
 };
 //#endregion
-//#region ../../packages/sync-engine/src/profiles.ts
+//#region ../../packages/sqlsync/src/profiles.ts
 const profileTableFor = (platform) => platform === "x" ? "x_profiles_raw" : "li_profiles_raw";
 //#endregion
-//#region ../../packages/sync-engine/src/sync.ts
+//#region ../../packages/sqlsync/src/sync.ts
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 const pageDelayFor = (pageDelayMs, pagesCompleted) => typeof pageDelayMs === "function" ? pageDelayMs(pagesCompleted) : pageDelayMs;
 var SyncPageError = class extends Error {
@@ -6761,7 +6749,7 @@ const walkRequest = async (args) => {
 				...args.parentId === void 0 ? {} : { parentId: args.parentId }
 			}),
 			objectCount: upserted,
-			lastSynced: null
+			lastSynced: Date.now()
 		});
 		partialCursorPersisted = true;
 		return true;
@@ -6873,7 +6861,10 @@ const parentIdsFromCache = (deps, collection) => {
 const runSync = async (deps, opts) => {
 	const { collection } = opts;
 	if (opts.since != null && collection.sinceField === void 0) throw new Error(`Collection ${collection.key} does not support --since`);
-	if (opts.since != null && collection.requiresFullInitialSync && deps.cache.getCursor(collection.key)?.lastSynced == null) throw new Error(`Collection ${collection.key} requires a full initial sync before --since`);
+	if (opts.since != null && collection.requiresFullInitialSync) {
+		const storedState = deps.cache.getCursor(collection.key);
+		if (storedState?.lastSynced == null || decodePartialSyncCursor(storedState.cursor)) throw new Error(`Collection ${collection.key} requires a full initial sync before --since`);
+	}
 	const credits = { spent: 0 };
 	let pages = 0;
 	let upserted = 0;
@@ -12514,7 +12505,7 @@ const buildSync$1 = (deps, platform) => defineCommand({
 const buildSql$1 = (deps, platform) => defineCommand({
 	meta: {
 		name: "sql",
-		description: "Query your synced local mirror with read-only SQL (free; run with no query to print tables)",
+		description: "Query your local mirror with read-only SQL (free; run with no query to print tables)",
 		capability: "read",
 		mutates: false,
 		schemaContract: {
@@ -12603,7 +12594,6 @@ const buildSql$1 = (deps, platform) => defineCommand({
 					}
 				});
 			} catch (error) {
-				if (error instanceof NeverSyncedError) throw new UsageError(incompleteSyncMessageFor(readonlyCache, error));
 				throw new UsageError(`Query failed (cache is read-only): ${error.message}`);
 			}
 		} finally {
@@ -12915,12 +12905,6 @@ const sentMessageRow = (args) => {
 		raw: JSON.stringify(raw)
 	};
 };
-const incompleteSyncMessageFor = (cache, error) => {
-	if (!error.tables.includes("li_conversations")) return error.message;
-	const rows = cache.query("SELECT count(*) AS count FROM li_conversations_raw")[0]?.count;
-	if (typeof rows !== "number" || rows <= 0) return error.message;
-	return `li_conversations has ${rows.toLocaleString("en-US")} rows from an incomplete messages sync (rate-limited before finishing) — run \`social linkedin sync messages\` to complete it before querying.`;
-};
 const buildMessageDelete = (deps) => {
 	return defineCommand({
 		meta: commandMeta$2({
@@ -13882,6 +13866,7 @@ const xProfileExtractors = {
 	"GET /users/:id": extractProfile,
 	"GET /users/:id/followers": extractList,
 	"GET /users/:id/following": extractList,
+	"GET /users/:id/timelines/reverse_chronological": extractIncludesUsers,
 	"GET /users/by/username/:username": extractProfile
 };
 const X_OPERATIONS = [
@@ -16636,11 +16621,10 @@ const defineOperationCommand = (op, deps) => defineRuntimeOperationCommand(xRunt
 //#endregion
 //#region ../../packages/x/src/cli/commands.ts
 const hiddenRootCommands = new Set(["search"]);
-const suppressedRootCommands = new Set(["bookmarks"]);
+const suppressedRootCommands = new Set(["bookmarks", "timeline"]);
 const rootCommandOrder = [
 	"profile",
 	"tweets",
-	"timeline",
 	"mentions",
 	"liked",
 	"followers",
@@ -16942,7 +16926,7 @@ const buildSql = (deps, platform) => {
 	return defineCommand({
 		meta: commandMeta$1({
 			name: "sql",
-			description: "Query your synced local mirror with read-only SQL (free; run with no query to print tables)",
+			description: "Query your local mirror with read-only SQL (free; run with no query to print tables)",
 			method: "GET",
 			capability: "read",
 			mutates: false,
@@ -17000,7 +16984,6 @@ const buildSql = (deps, platform) => {
 						}
 					});
 				} catch (error) {
-					if (error instanceof NeverSyncedError) throw new UsageError(error.message);
 					throw new UsageError(`Query failed (cache is read-only): ${error.message}`);
 				}
 			} finally {
@@ -21173,7 +21156,7 @@ function createEnv(opts) {
 }
 //#endregion
 //#region package.json
-var version$1 = "0.9.0";
+var version$1 = "0.10.0";
 //#endregion
 //#region src/lib/env.ts
 const URLWithTrailingSlash = url().transform(ensureTrailingSlash);