github-stars-organizer 1.3.2 → 1.4.0

package/dist/app/index.html

@@ -17,16 +17,16 @@
     <meta property="og:image:height" content="600" />
     <meta property="og:image:alt" content="Stars Organizer: finally do something with your GitHub stars. Lists synced to GitHub, a health score per repo, tags, ratings and notes." />
     <meta name="twitter:card" content="summary_large_image" />
-    <script type="module" crossorigin src="/assets/index-BuYchyhs.js"></script>
+    <script type="module" crossorigin src="/assets/index-Z9aIL5Tz.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/sync-persistence-BJbWXISF.js">
-    <link rel="modulepreload" crossorigin href="/assets/button-r9cVFa0_.js">
-    <link rel="modulepreload" crossorigin href="/assets/schemas-DVvZEnxp.js">
-    <link rel="modulepreload" crossorigin href="/assets/star-BPue5Y4t.js">
-    <link rel="modulepreload" crossorigin href="/assets/coerce-Cxjr6MIU.js">
-    <link rel="modulepreload" crossorigin href="/assets/history-CN5yGwhZ.js">
-    <link rel="modulepreload" crossorigin href="/assets/routes-DaKmAWCG.js">
-    <link rel="modulepreload" crossorigin href="/assets/list._listId-CNuYrPaQ.js">
-    <link rel="stylesheet" crossorigin href="/assets/index-dVYqSW2P.css">
+    <link rel="modulepreload" crossorigin href="/assets/button-srM_gVNp.js">
+    <link rel="modulepreload" crossorigin href="/assets/schemas-CLMWt96T.js">
+    <link rel="modulepreload" crossorigin href="/assets/star-D-XjWe95.js">
+    <link rel="modulepreload" crossorigin href="/assets/coerce-hGm-kFoB.js">
+    <link rel="modulepreload" crossorigin href="/assets/history-BeQkAZPX.js">
+    <link rel="modulepreload" crossorigin href="/assets/routes-CIYRvBg6.js">
+    <link rel="modulepreload" crossorigin href="/assets/list._listId-BthjMh8l.js">
+    <link rel="stylesheet" crossorigin href="/assets/index-CEpF9MZu.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/cli.js

@@ -1270,6 +1270,13 @@ function addReposToLists(client, additions) {
 async function addStar(client, repoNodeId) {
 	await client.graphql(`mutation($input: AddStarInput!) { addStar(input: $input) { starrable { id } } }`, { input: { starrableId: repoNodeId } });
 }
+var SELF_REPO = {
+	owner: "armanckeser",
+	name: "github-stars-organizer"
+};
+async function starSelf(client) {
+	await client.rest("PUT", `/user/starred/${SELF_REPO.owner}/${SELF_REPO.name}`);
+}
 async function unstar(client, owner, name) {
 	await client.rest("DELETE", `/user/starred/${encodeURIComponent(owner)}/${encodeURIComponent(name)}`);
 }
@@ -7377,6 +7384,10 @@ function createLocalServer({ github, appDir, port, store, login }) {
 		const listIds = await changeRepoList(github, await c.req.json());
 		return c.json({ listIds });
 	});
+	api.post("/star-self", async (c) => {
+		await starSelf(github);
+		return c.json({});
+	});
 	api.post("/unstar", async (c) => {
 		const { owner, name } = await c.req.json();
 		await unstar(github, owner, name);
@@ -7463,14 +7474,116 @@ async function launch({ github, login, home, appDir, port }) {
 	};
 }
 //#endregion
+//#region src/lib/star-waves.ts
+var QUIET_AFTER_MS = 182 * 864e5;
+function isQuiet(repo, now) {
+	if (repo.is_archived) return true;
+	if (!repo.pushed_at) return true;
+	return now - Date.parse(repo.pushed_at) >= QUIET_AFTER_MS;
+}
+var DEFAULT_LIMIT = 10;
+var DESCRIPTION_CHARS = 100;
+function indexFile(home) {
+	return path.join(home, "search-index.json");
+}
+async function readIndex(home) {
+	try {
+		return JSON.parse(await readFile(indexFile(home), "utf8"));
+	} catch {
+		return null;
+	}
+}
+function isStale(index, now) {
+	return !index || now - Date.parse(index.refreshedAt) >= 864e5;
+}
+/** Every star with the names of the Lists it is in, read fresh from GitHub. */
+async function buildIndex(github, login, now) {
+	const lists = await fetchViewerLists(github.graphql);
+	const listsOf = /* @__PURE__ */ new Map();
+	for (const list of lists) for (const repo of list.repos) listsOf.set(repo.fullName, [...listsOf.get(repo.fullName) ?? [], list.name]);
+	const stars = [];
+	for await (const edges of starredPages(github)) for (const { node, starredAt } of edges) stars.push({
+		fullName: node.nameWithOwner,
+		description: node.description,
+		language: node.primaryLanguage?.name ?? null,
+		topics: topicsOf(node).split(",").filter(Boolean),
+		stars: node.stargazerCount,
+		isArchived: node.isArchived ?? false,
+		pushedAt: node.pushedAt ?? null,
+		starredAt,
+		lists: listsOf.get(node.nameWithOwner) ?? []
+	});
+	return {
+		login,
+		refreshedAt: now.toISOString(),
+		stars
+	};
+}
+async function saveIndex(home, index) {
+	await mkdir(home, { recursive: true });
+	const file = indexFile(home);
+	const partial = `${file}.${randomUUID()}.partial`;
+	await writeFile(partial, JSON.stringify(index));
+	await rename(partial, file);
+}
+function termsOf(query) {
+	return [...new Set(query.toLowerCase().split(/[\s,]+/).filter((term) => term.length > 1))];
+}
+/**
+* Stars matching any of the words, best first. A word in the repo name counts
+* most, then topics and List names, then the description and language.
+*/
+function searchStars(stars, query, limit = DEFAULT_LIMIT) {
+	const terms = termsOf(query);
+	if (!terms.length) return [];
+	return stars.map((star) => {
+		const name = star.fullName.toLowerCase();
+		const tags = [...star.topics, ...star.lists].join(" ").toLowerCase();
+		const text = `${star.description ?? ""} ${star.language ?? ""}`.toLowerCase();
+		let score = 0;
+		for (const term of terms) {
+			if (name.includes(term)) score += 3;
+			if (tags.includes(term)) score += 2;
+			if (text.includes(term)) score += 1;
+		}
+		return {
+			star,
+			score
+		};
+	}).filter(({ score }) => score > 0).sort((a, b) => b.score - a.score || b.star.stars - a.star.stars).slice(0, limit).map(({ star }) => star);
+}
+function ago(iso, now) {
+	const days = Math.floor((now - Date.parse(iso)) / 864e5);
+	if (days < 1) return "today";
+	if (days < 60) return `${days}d ago`;
+	if (days < 730) return `${Math.floor(days / 30)}mo ago`;
+	return `${Math.floor(days / 365)}y ago`;
+}
+function compactCount(n) {
+	return n >= 1e3 ? `${(n / 1e3).toFixed(n >= 1e4 ? 0 : 1)}k` : String(n);
+}
+/** One line per star for an agent to read: name, size, Lists, and whether it is still alive. */
+function formatResults(results, now) {
+	return results.map((star) => {
+		const state = star.isArchived ? "ARCHIVED" : isQuiet({
+			is_archived: false,
+			pushed_at: star.pushedAt
+		}, now) ? `QUIET, last push ${star.pushedAt ? ago(star.pushedAt, now) : "never"}` : `active, last push ${star.pushedAt ? ago(star.pushedAt, now) : "unknown"}`;
+		const lists = star.lists.length ? ` · Lists: ${star.lists.join(", ")}` : "";
+		const description = star.description ? `\n  ${star.description.length > DESCRIPTION_CHARS ? `${star.description.slice(0, DESCRIPTION_CHARS - 1)}…` : star.description}` : "";
+		return `${star.fullName} · ${compactCount(star.stars)} stars · ${state}${lists}${description}`;
+	}).join("\n");
+}
+//#endregion
 //#region cli/src/cli.ts
 var DEFAULT_PORT = 5185;
 var EXIT_FAILURE = 1;
-var NOTICE = `Stars Organizer v1.3.2  Copyright (C) 2026 Armanc Keser
+var NOTICE = `Stars Organizer v1.4.0  Copyright (C) 2026 Armanc Keser
 Free software under the GNU AGPL v3 or later, with ABSOLUTELY NO WARRANTY.
 Source, license and bundled licenses: https://github.com/armanckeser/github-stars-organizer
 Not affiliated with or endorsed by GitHub.`;
 var HELP = `Usage: npx github-stars-organizer [--port <number>] [--no-open]
+       npx github-stars-organizer search <words> [--refresh] [--json] [--limit <n>]
 
 Opens Stars Organizer on http://127.0.0.1:${DEFAULT_PORT} using your GitHub
 login from the gh CLI (or GITHUB_TOKEN, if set). Tags, ratings and notes are
@@ -7480,6 +7593,12 @@ saved in this browser; Lists and unstars are written to GitHub.
   --no-open        Print the address without opening a browser.
   --help           Show this message.
 
+search prints the stars that match any of the words (name, topics, Lists,
+description), with each repo's Lists and whether it is archived or quiet
+(no push in 6 months). It reads a copy of your stars kept on disk and
+refreshes it from GitHub once a day, or now with --refresh. For coding
+agents: check the user's stars before suggesting a library or tool.
+
 Before opening, it backs up your stars and Lists to
 ~/.github-stars-organizer/backups (set ${HOME_ENV} to move it).
 It talks only to api.github.com, with your token; nothing else is sent anywhere.
@@ -7530,16 +7649,58 @@ function parsePort(value) {
 	if (!Number.isInteger(port) || port < 1 || port > 65535) throw new CliError(`--port must be a number from 1 to 65535, got "${value}".`);
 	return port;
 }
+function parseLimit(value) {
+	if (value === void 0) return void 0;
+	const limit = Number(value);
+	if (!Number.isInteger(limit) || limit < 1) throw new CliError(`--limit must be a whole number above 0, got "${value}".`);
+	return limit;
+}
+async function search(words, options) {
+	const query = words.join(" ").trim();
+	if (!query) throw new CliError("Say what to look for, e.g. `npx github-stars-organizer search pdf parser`.");
+	const limit = parseLimit(options.limit);
+	const home = defaultHome();
+	const now = /* @__PURE__ */ new Date();
+	let index = await readIndex(home);
+	if (options.refresh || isStale(index, now.getTime())) {
+		const github = createGitHubClient(await resolveToken());
+		console.error("Reading your stars and Lists from GitHub (once a day; about 30 seconds for 500 stars)...");
+		index = await buildIndex(github, await signedInAs(github), now);
+		await saveIndex(home, index);
+	}
+	const results = searchStars(index.stars, query, limit);
+	if (options.json) {
+		console.log(JSON.stringify({
+			login: index.login,
+			refreshedAt: index.refreshedAt,
+			results
+		}, null, 2));
+		return;
+	}
+	if (!results.length) {
+		console.log(`None of @${index.login}'s ${index.stars.length} stars match "${query}".`);
+		return;
+	}
+	console.log(formatResults(results, now.getTime()));
+}
 async function main() {
-	const { values } = parseArgs({ options: {
-		port: { type: "string" },
-		"no-open": { type: "boolean" },
-		help: { type: "boolean" }
-	} });
+	const { values, positionals } = parseArgs({
+		allowPositionals: true,
+		options: {
+			port: { type: "string" },
+			"no-open": { type: "boolean" },
+			help: { type: "boolean" },
+			refresh: { type: "boolean" },
+			json: { type: "boolean" },
+			limit: { type: "string" }
+		}
+	});
 	if (values.help) {
 		console.log(HELP);
 		return;
 	}
+	if (positionals[0] === "search") return search(positionals.slice(1), values);
+	if (positionals.length) throw new CliError(`Unknown command "${positionals[0]}". Run with --help to see the options.`);
 	console.log(`${NOTICE}\n`);
 	const port = parsePort(values.port);
 	const url = `http://127.0.0.1:${port}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-stars-organizer",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "description": "Search, tag, rate and sort your GitHub stars into Lists, using your gh login. Runs locally; nothing to host.",
   "license": "AGPL-3.0-or-later",
   "author": "Armanc Keser",