github-stars-organizer 1.2.0 → 1.3.0

package/dist/cli.js

@@ -668,6 +668,429 @@ function withItems(graphql, lists) {
 async function fetchViewerLists(graphql) {
 	return withItems(graphql, await fetchListNodes(graphql, VIEWER_LISTS_QUERY, null));
 }
+var README_LEAD_CHARS = 4e3;
+var PER_PAGE_LIMIT = 30;
+var RESULT_LIMIT = 8;
+var MIN_STARS = 10;
+var DAY_MS$1 = 864e5;
+var MIN_SCORE = 2.5;
+var LIST_NAME = /awesome|dotfiles|^\.?config|examples|templates|cookbook|tips|resources|curated|^free-for/i;
+var LIST_DESCRIPTION = /curated list|list of|collection of|my (dotfiles|config|setup)/i;
+var BROAD_TOPICS = new Set([
+	"javascript",
+	"typescript",
+	"python",
+	"python3",
+	"go",
+	"golang",
+	"rust",
+	"java",
+	"kotlin",
+	"swift",
+	"c",
+	"cpp",
+	"c-plus-plus",
+	"csharp",
+	"dotnet",
+	"php",
+	"ruby",
+	"scala",
+	"elixir",
+	"haskell",
+	"lua",
+	"shell",
+	"bash",
+	"zsh",
+	"nodejs",
+	"node",
+	"node-js",
+	"deno",
+	"react",
+	"reactjs",
+	"vue",
+	"vuejs",
+	"svelte",
+	"sveltekit",
+	"nextjs",
+	"angular",
+	"flutter",
+	"dart",
+	"html",
+	"css",
+	"tailwindcss",
+	"cli",
+	"terminal",
+	"command-line",
+	"command-line-tool",
+	"tool",
+	"tools",
+	"library",
+	"framework",
+	"api",
+	"rest-api",
+	"app",
+	"application",
+	"core",
+	"main",
+	"web",
+	"webapp",
+	"website",
+	"server",
+	"client",
+	"linux",
+	"macos",
+	"windows",
+	"android",
+	"ios",
+	"mobile",
+	"mobile-app",
+	"desktop",
+	"cross-platform",
+	"docker",
+	"kubernetes",
+	"self-hosted",
+	"selfhosted",
+	"open-source",
+	"opensource",
+	"free",
+	"hacktoberfest",
+	"awesome",
+	"awesome-list",
+	"list",
+	"github",
+	"git",
+	"productivity",
+	"utility",
+	"ai",
+	"llm",
+	"machine-learning",
+	"deep-learning",
+	"artificial-intelligence",
+	"chatgpt",
+	"openai",
+	"browser",
+	"database",
+	"backend",
+	"frontend",
+	"fullstack",
+	"devops",
+	"security",
+	"automation",
+	"javascript-library",
+	"typescript-library",
+	"python-library",
+	"npm",
+	"pypi",
+	"crate",
+	"plugin"
+]);
+var STOPWORDS = new Set([
+	"a",
+	"an",
+	"the",
+	"and",
+	"or",
+	"for",
+	"of",
+	"to",
+	"in",
+	"on",
+	"with",
+	"by",
+	"from",
+	"as",
+	"at",
+	"is",
+	"are",
+	"be",
+	"it",
+	"its",
+	"that",
+	"this",
+	"your",
+	"you",
+	"into",
+	"via",
+	"using",
+	"use",
+	"based",
+	"written",
+	"simple",
+	"fast",
+	"blazing",
+	"modern",
+	"lightweight",
+	"tiny",
+	"small",
+	"powerful",
+	"easy",
+	"minimal",
+	"beautiful",
+	"highly",
+	"customizable",
+	"open",
+	"source",
+	"free",
+	"high",
+	"performance",
+	"best",
+	"new",
+	"awesome",
+	"official",
+	"library",
+	"tool",
+	"tools",
+	"app",
+	"project",
+	"framework",
+	"implementation",
+	"collection",
+	"solution",
+	"way",
+	"just",
+	"like",
+	"clone",
+	"alternative",
+	"replacement",
+	"supercharge",
+	"even",
+	"works",
+	"entire",
+	"made",
+	"command-line",
+	"command",
+	"line",
+	"cli",
+	"user-friendly",
+	"cross-platform",
+	"fancy",
+	"system",
+	"platform",
+	"code",
+	"elements",
+	"linux",
+	"macos",
+	"windows",
+	"can",
+	"will",
+	"also",
+	"all",
+	"any",
+	"get",
+	"make",
+	"run",
+	"running",
+	"see",
+	"more",
+	"other",
+	"one",
+	"software",
+	"support",
+	"supports",
+	"feature",
+	"features",
+	"install",
+	"installation",
+	"using",
+	"about",
+	"how",
+	"what",
+	"which",
+	"when",
+	"there",
+	"here",
+	"they",
+	"them",
+	"their",
+	"our",
+	"we",
+	"has",
+	"have",
+	"not",
+	"but",
+	"if",
+	"so",
+	"up",
+	"out",
+	"only",
+	"most",
+	"some",
+	"such",
+	"than",
+	"then",
+	"these",
+	"those",
+	"very",
+	"well",
+	"want",
+	"need",
+	"needs",
+	"please",
+	"note",
+	"help",
+	"docs",
+	"documentation",
+	"license",
+	"contributing",
+	"contributors",
+	"release",
+	"releases",
+	"version",
+	"download",
+	"build",
+	"github",
+	"com",
+	"www",
+	"readme"
+]);
+function parseTopics(topics) {
+	return topics?.split(",").map((t) => t.trim()).filter(Boolean) ?? [];
+}
+function ownNames(source) {
+	const [owner, name] = source.full_name.toLowerCase().split("/");
+	const project = BROAD_TOPICS.has(name) ? owner : name;
+	const joined = project.replace(/[-_.]/g, "");
+	return joined === project ? [project] : [project, joined];
+}
+function mentionsOwnName(text, names) {
+	const lower = text.toLowerCase();
+	return names.some((n) => new RegExp(`(^|[^a-z0-9])${n.replace(/[.]/g, "\\.")}([^a-z0-9]|$)`).test(lower));
+}
+function hasWord(words, part) {
+	return words.findIndex((w) => w === part || w === `${part}s` || w === part.replace(/s$/, "") || w.split("-").includes(part));
+}
+function specificTopics(source) {
+	const language = source.language?.toLowerCase();
+	const names = ownNames(source);
+	const words = descriptionWords(source.description);
+	return parseTopics(source.topics).filter((t) => !BROAD_TOPICS.has(t) && t !== language && !mentionsOwnName(t, names)).map((topic) => {
+		const parts = topic.split("-").filter((part) => !STOPWORDS.has(part));
+		const positions = parts.map((part) => hasWord(words, part)).filter((i) => i >= 0);
+		const fraction = positions.length / parts.length;
+		const first = positions.length > 0 ? Math.min(...positions) : words.length;
+		return {
+			topic,
+			fraction,
+			relevance: 3 * fraction + .3 * Math.min(parts.length, 3) - .05 * first
+		};
+	}).filter((t) => t.fraction > 0).sort((a, b) => b.relevance - a.relevance).map((t) => t.topic);
+}
+function readmeLead(markdown) {
+	return markdown.replace(/```[\s\S]*?```/g, " ").replace(/<!--[\s\S]*?-->/g, " ").replace(/<[^>]+>/g, " ").replace(/!\[[^\]]*\]\([^)]*\)/g, " ").replace(/\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/https?:\/\/\S+/g, " ").replace(/`[^`]*`/g, " ").replace(/&[a-z]+;|&#\d+;/g, " ").slice(0, README_LEAD_CHARS);
+}
+function keyWords(source) {
+	const names = ownNames(source);
+	const language = source.language?.toLowerCase();
+	const described = descriptionWords(source.description).filter((w) => !mentionsOwnName(w, names) && w !== language);
+	const counts = /* @__PURE__ */ new Map();
+	for (const w of source.readme ? wordsOf(source.readme) : []) if (!mentionsOwnName(w, names) && w !== language) counts.set(w, (counts.get(w) ?? 0) + 1);
+	const fromReadme = [...counts.entries()].filter(([w, n]) => n >= 3 && !described.includes(w)).sort((a, b) => b[1] - a[1]).map(([w]) => w);
+	const rank = (w) => counts.get(w) ?? 0;
+	const hasReadme = counts.size > 0;
+	return [...described.map((w, i) => ({
+		w,
+		score: (hasReadme ? 2 * rank(w) + 4 : 100) - .1 * i
+	})), ...fromReadme.map((w, i) => ({
+		w,
+		score: rank(w) - .1 * i
+	}))].sort((a, b) => b.score - a.score).map(({ w }) => w);
+}
+function wordsOf(text) {
+	return text.toLowerCase().replace(/:[a-z0-9_+-]+:/g, " ").split(/[^a-z0-9+#.-]+/).map((w) => w.replace(/^[.-]+|[.-]+$/g, "")).filter((w) => w.length > 2 && /[a-z]/.test(w) && !STOPWORDS.has(w));
+}
+function descriptionWords(description) {
+	if (!description) return [];
+	const words = description.toLowerCase().replace(/:[a-z0-9_+-]+:/g, " ").replace(/\([^)]*\)/g, " ").split(/[^a-z0-9+#.-]+/).map((w) => w.replace(/^[.-]+|[.-]+$/g, "")).filter((w) => w.length > 1 && /[a-z]/.test(w) && !STOPWORDS.has(w));
+	return [...new Set(words)];
+}
+function minStars(source) {
+	return Math.round(Math.min(300, Math.max(MIN_STARS, source.stars / 200)));
+}
+function buildQueries(source) {
+	const filters = `fork:false archived:false stars:>=${minStars(source)}`;
+	const topics = specificTopics(source);
+	const names = ownNames(source);
+	const topicWords = new Set(topics.flatMap((t) => t.split("-")));
+	const words = keyWords(source).map((w, i) => ({
+		w,
+		rank: (topicWords.has(w) ? 0 : 10) + i
+	})).sort((a, b) => a.rank - b.rank).map(({ w }) => w).slice(0, 2);
+	const queries = [];
+	if (topics.length >= 1) queries.push({
+		kind: "topic",
+		q: `topic:${topics[0]} ${filters}`,
+		sort: "stars"
+	});
+	if (words.length >= 2) queries.push({
+		kind: "words",
+		q: `${words.join(" ")} in:name,description,topics ${filters}`,
+		sort: "best-match"
+	});
+	queries.push({
+		kind: "readme",
+		q: `${names[0]} in:readme ${words[0] ?? ""} ${filters}`.replace(/\s+/g, " "),
+		sort: "stars"
+	});
+	return queries.slice(0, 3);
+}
+function overlap(a, b) {
+	return a.filter((x) => b.has(x)).length;
+}
+function rankSimilar(source, results, now = Date.now()) {
+	const self = source.full_name.toLowerCase();
+	const sourceTopics = parseTopics(source.topics);
+	const specific = new Set(specificTopics(source));
+	const sourceWords = new Set(keyWords(source).slice(0, 12));
+	const names = ownNames(source);
+	const pool = /* @__PURE__ */ new Map();
+	for (const { kind, items } of results) for (const item of items.slice(0, PER_PAGE_LIMIT)) {
+		const key = item.full_name.toLowerCase();
+		if (key === self || item.fork || item.archived) continue;
+		const entry = pool.get(key) ?? {
+			item,
+			hits: 0,
+			comparesItself: false
+		};
+		entry.hits++;
+		if (kind === "readme") entry.comparesItself = true;
+		pool.set(key, entry);
+	}
+	const maxStars = Math.max(1, ...[...pool.values()].map(({ item }) => item.stargazers_count));
+	const related = [...pool.values()].map(({ item, hits, comparesItself }) => {
+		const topics = item.topics ?? [];
+		const topicSet = new Set(topics);
+		const shared = sourceTopics.filter((t) => topicSet.has(t));
+		const sharedSpecific = shared.filter((t) => specific.has(t));
+		const words = [...descriptionWords(item.description), ...topics.flatMap((t) => t.split("-"))];
+		const wordOverlap = sourceWords.size > 0 ? overlap(words, sourceWords) / Math.sqrt(sourceWords.size * Math.max(1, words.length)) : 0;
+		const days = item.pushed_at ? (now - Date.parse(item.pushed_at)) / DAY_MS$1 : Infinity;
+		const addOn = mentionsOwnName(`${item.full_name.split("/")[1]} ${item.description ?? ""}`, names);
+		const roundup = LIST_NAME.test(item.full_name.split("/")[1]) || LIST_DESCRIPTION.test(item.description ?? "");
+		const score = 2 * sharedSpecific.length + .5 * (shared.length - sharedSpecific.length) + 3 * wordOverlap + 1 * (hits - 1) + (comparesItself ? 1.5 : 0) + (source.language && item.language === source.language ? .5 : 0) + 2 * (Math.log10(item.stargazers_count + 1) / Math.log10(maxStars + 1)) - (days > 730 ? 1 : days > 365 ? .4 : 0);
+		return {
+			full_name: item.full_name,
+			url: item.html_url,
+			description: item.description,
+			language: item.language,
+			stars: item.stargazers_count,
+			pushed_at: item.pushed_at,
+			shared_topics: [...sharedSpecific, ...shared.filter((t) => !specific.has(t))],
+			score: Math.round(score * 100) / 100,
+			related: !addOn && !roundup && (shared.some((t) => !BROAD_TOPICS.has(t)) || wordOverlap > 0)
+		};
+	}).filter((r) => r.related).sort((a, b) => b.score - a.score);
+	const cutoff = Math.max(MIN_SCORE, (related[0]?.score ?? 0) * .55);
+	return related.filter((r) => r.score >= cutoff).slice(0, RESULT_LIMIT).map(({ related: _, ...repo }) => repo);
+}
+async function findSimilar(source, search, now = Date.now()) {
+	const queries = buildQueries(source);
+	const results = [];
+	for (const { kind, q, sort } of queries) results.push({
+		kind,
+		items: await search(q, sort)
+	});
+	return rankSimilar(source, results, now);
+}
 //#endregion
 //#region server/github.ts
 var DEFAULT_API_URL = "https://api.github.com";
@@ -702,6 +1125,12 @@ function createGitHubClient(token, apiUrl = process.env.GITHUB_API_URL ?? DEFAUL
 			if (json.errors?.length) throw new GitHubError(502, json.errors[0].message);
 			return json.data;
 		},
+		get(path, accept = "application/vnd.github+json") {
+			return request(`${apiUrl}${path}`, { headers: {
+				...headers,
+				Accept: accept
+			} });
+		},
 		async rest(method, path) {
 			const response = await request(`${apiUrl}${path}`, {
 				method,
@@ -844,6 +1273,42 @@ async function addStar(client, repoNodeId) {
 async function unstar(client, owner, name) {
 	await client.rest("DELETE", `/user/starred/${encodeURIComponent(owner)}/${encodeURIComponent(name)}`);
 }
+async function tokenInfo(client) {
+	const response = await client.get("/user");
+	const json = await response.json().catch(() => ({}));
+	if (!response.ok) throw new GitHubError(response.status, json.message ?? `GitHub returned ${response.status}.`);
+	const header = response.headers.get("x-oauth-scopes");
+	return {
+		login: json.login ?? "",
+		scopes: header === null ? null : header.split(",").map((s) => s.trim()).filter(Boolean)
+	};
+}
+var SEARCH_PAGE_SIZE = 30;
+async function searchRepositories(client, q, sort) {
+	const params = new URLSearchParams({
+		q,
+		per_page: String(SEARCH_PAGE_SIZE)
+	});
+	if (sort === "stars") params.set("sort", "stars");
+	const response = await client.get(`/search/repositories?${params}`);
+	const json = await response.json().catch(() => ({}));
+	if (response.status === 403 || response.status === 429) throw new GitHubError(429, "GitHub allows 30 searches a minute. Try again in a minute.");
+	if (!response.ok) throw new GitHubError(response.status, json.message ?? `GitHub returned ${response.status}.`);
+	return json.items ?? [];
+}
+/** The README's opening prose, or null when the repo has none. */
+async function readmeOpening(client, fullName) {
+	const response = await client.get(`/repos/${fullName}/readme`, "application/vnd.github.raw");
+	if (!response.ok) return null;
+	return readmeLead(await response.text());
+}
+async function similarTo(client, source) {
+	const readme = await readmeOpening(client, source.full_name);
+	return findSimilar({
+		...source,
+		readme
+	}, (q, sort) => searchRepositories(client, q, sort));
+}
 //#endregion
 //#region src/lib/local-api.ts
 var LOCAL_APP_SIGNATURE = "github-stars-organizer";
@@ -6917,6 +7382,15 @@ function createLocalServer({ github, appDir, port, store, login }) {
 		await unstar(github, owner, name);
 		return c.json({});
 	});
+	api.get("/token", async (c) => c.json({
+		connected: true,
+		...await tokenInfo(github)
+	}));
+	api.post("/similar", async (c) => {
+		const { repo } = await c.req.json();
+		if (!repo?.full_name) return c.json({ error: "Which repo?" }, 400);
+		return c.json({ similar: await similarTo(github, repo) });
+	});
 	api.get("/backups", async (c) => c.json({
 		directory: store.directory,
 		backups: await store.list()
@@ -6992,7 +7466,7 @@ async function launch({ github, login, home, appDir, port }) {
 //#region cli/src/cli.ts
 var DEFAULT_PORT = 5185;
 var EXIT_FAILURE = 1;
-var NOTICE = `Stars Organizer v1.2.0  Copyright (C) 2026 Armanc Keser
+var NOTICE = `Stars Organizer v1.3.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.`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-stars-organizer",
-  "version": "1.2.0",
+  "version": "1.3.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",

package/dist/app/assets/badge-DWmLT6OI.js

@@ -1 +0,0 @@
-import{R as e,a as t,m as n,n as r,r as i}from"./button-C0MQwO-R.js";var a=e(`external-link`,[[`path`,{d:`M15 3h6v6`,key:`1q9fwt`}],[`path`,{d:`M10 14 21 3`,key:`gplh6r`}],[`path`,{d:`M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6`,key:`a6xqqp`}]]);function o(e){return t(e.defaultTagName??`div`,e,e)}var s=i(`group/badge inline-flex h-5 w-fit shrink-0 items-center justify-center gap-1 overflow-hidden rounded-4xl border border-transparent px-2 py-0.5 text-xs font-medium whitespace-nowrap transition-all focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 [&>svg]:pointer-events-none [&>svg]:size-3!`,{variants:{variant:{default:`bg-primary text-primary-foreground [a]:hover:bg-primary/80`,secondary:`bg-secondary text-secondary-foreground [a]:hover:bg-secondary/80`,destructive:`bg-destructive/10 text-destructive focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:focus-visible:ring-destructive/40 [a]:hover:bg-destructive/20`,outline:`border-border text-foreground [a]:hover:bg-muted [a]:hover:text-muted-foreground`,ghost:`hover:bg-muted hover:text-muted-foreground dark:hover:bg-muted/50`,link:`text-primary underline-offset-4 hover:underline`}},defaultVariants:{variant:`default`}});function c({className:e,variant:t=`default`,render:i,...a}){return o({defaultTagName:`span`,props:n({className:r(s({variant:t}),e)},a),render:i,state:{slot:`badge`,variant:t}})}export{a as n,c as t};