@f0rbit/overview 0.1.0 → 0.2.1

package/packages/core/src/concurrency.ts

@@ -1,44 +0,0 @@
-/**
- * Concurrency pool — limits the number of concurrent async operations.
- *
- * Use when spawning many parallel subprocesses (e.g., scanning 50+ repos at startup)
- * to avoid overwhelming the system.
- */
-export function createPool(concurrency: number) {
-	let active = 0;
-	const queue: Array<() => void> = [];
-
-	function release() {
-		active--;
-		const next = queue.shift();
-		if (next) {
-			active++;
-			next();
-		}
-	}
-
-	return {
-		/** Run an async function within the concurrency limit */
-		async run<T>(fn: () => Promise<T>): Promise<T> {
-			if (active < concurrency) {
-				active++;
-				try {
-					return await fn();
-				} finally {
-					release();
-				}
-			}
-			return new Promise<T>((resolve, reject) => {
-				queue.push(() => {
-					fn().then(resolve, reject).finally(release);
-				});
-			});
-		},
-
-		/** Current number of active tasks */
-		get active_count() { return active; },
-
-		/** Current number of queued tasks */
-		get queue_length() { return queue.length; },
-	};
-}

package/packages/core/src/devpad.ts

@@ -1,61 +0,0 @@
-export interface DevpadProject {
-	id: string;
-	project_id: string;
-	name: string;
-	description: string | null;
-	status: string;
-	repo_url: string | null;
-}
-
-export interface DevpadTask {
-	id: string;
-	title: string;
-	description: string | null;
-	priority: "LOW" | "MEDIUM" | "HIGH";
-	progress: "UNSTARTED" | "IN_PROGRESS" | "COMPLETED";
-	project_id: string | null;
-	tags: string[];
-}
-
-export interface DevpadMilestone {
-	id: string;
-	name: string;
-	target_version: string | null;
-	target_time: string | null;
-	finished_at: string | null;
-	goals_total: number;
-	goals_completed: number;
-}
-
-export interface DevpadRepoData {
-	project: DevpadProject | null;
-	tasks: DevpadTask[];
-	milestones: DevpadMilestone[];
-}
-
-export function normalizeGitUrl(url: string): string {
-	let normalized = url
-		.trim()
-		.replace(/\.git$/, "")
-		.replace(/\/$/, "");
-	const ssh_match = normalized.match(/^git@([^:]+):(.+)$/);
-	if (ssh_match) {
-		normalized = `https://${ssh_match[1]}/${ssh_match[2]}`;
-	}
-	return normalized.toLowerCase();
-}
-
-export function matchRepoToProject(
-	remote_url: string | null,
-	repo_name: string,
-	projects: DevpadProject[],
-): DevpadProject | null {
-	if (remote_url) {
-		const normalized = normalizeGitUrl(remote_url);
-		const match = projects.find(
-			(p) => p.repo_url && normalizeGitUrl(p.repo_url) === normalized,
-		);
-		if (match) return match;
-	}
-	return projects.find((p) => p.project_id === repo_name) ?? null;
-}

package/packages/core/src/git-graph.ts

@@ -1,54 +0,0 @@
-import { ok, err, type Result } from "@f0rbit/corpus";
-import type { GitGraphOutput } from "./types";
-
-export type GitGraphError = { kind: "graph_failed"; path: string; cause: string };
-
-const DEFAULT_LIMIT = 40;
-
-// Strip ANSI escape codes in case git config forces color
-const ANSI_RE = /\x1b\[[0-9;]*m/g;
-const stripAnsi = (s: string): string => s.replace(ANSI_RE, "");
-
-const stripTrailingEmpty = (lines: string[]): string[] => {
-	let end = lines.length;
-	while (end > 0 && lines[end - 1]!.trim() === "") end--;
-	return lines.slice(0, end);
-};
-
-export async function captureGraph(
-	repoPath: string,
-	options?: { limit?: number },
-): Promise<Result<GitGraphOutput, GitGraphError>> {
-	const limit = options?.limit ?? DEFAULT_LIMIT;
-
-	const proc = Bun.spawn(
-		["git", "log", "--graph", "--all", "--decorate", "--oneline", `-n`, `${limit}`, "--color=never"],
-		{
-			cwd: repoPath,
-			stdout: "pipe",
-			stderr: "pipe",
-		},
-	);
-
-	const [stdout, stderr, exit_code] = await Promise.all([
-		new Response(proc.stdout).text(),
-		new Response(proc.stderr).text(),
-		proc.exited,
-	]);
-
-	if (exit_code !== 0) {
-		// empty repo (no commits) exits non-zero — treat as empty
-		if (stderr.includes("does not have any commits")) {
-			return ok({ lines: [], total_lines: 0, repo_path: repoPath });
-		}
-		return err({ kind: "graph_failed", path: repoPath, cause: stderr.trim() });
-	}
-
-	const lines = stripTrailingEmpty(stdout.split("\n").map(stripAnsi));
-
-	return ok({
-		lines,
-		total_lines: lines.length,
-		repo_path: repoPath,
-	});
-}

package/packages/core/src/git-stats.ts

@@ -1,201 +0,0 @@
-// Heavyweight on-demand git stats
-import { ok, err, type Result } from "@f0rbit/corpus";
-import type { RecentCommit } from "./types";
-
-export type GitStatsError =
-	| { kind: "not_a_repo"; path: string }
-	| { kind: "stats_failed"; path: string; cause: string };
-
-export interface ExtendedStats {
-	contributor_count: number;
-	contributors: string[];
-	repo_size_bytes: number;
-	tags: string[];
-	recent_commits: RecentCommit[];
-	total_commits: number;
-}
-
-async function git(args: string[], cwd: string): Promise<Result<string, GitStatsError>> {
-	try {
-		const proc = Bun.spawn(["git", ...args], {
-			cwd,
-			stdout: "pipe",
-			stderr: "pipe",
-		});
-
-		const [stdout, stderr, exit_code] = await Promise.all([
-			new Response(proc.stdout).text(),
-			new Response(proc.stderr).text(),
-			proc.exited,
-		]);
-
-		if (exit_code !== 0) {
-			if (stderr.includes("not a git repository")) {
-				return err({ kind: "not_a_repo", path: cwd });
-			}
-			return err({ kind: "stats_failed", path: cwd, cause: stderr.trim() });
-		}
-
-		return ok(stdout);
-	} catch (e) {
-		return err({
-			kind: "stats_failed",
-			path: cwd,
-			cause: e instanceof Error ? e.message : String(e),
-		});
-	}
-}
-
-export function parseSize(size_str: string): number {
-	const trimmed = size_str.trim();
-	if (trimmed === "0 bytes" || trimmed === "0") return 0;
-
-	const match = trimmed.match(/^([\d.]+)\s*(\w+)?$/);
-	if (!match) return 0;
-
-	const value = parseFloat(match[1] ?? "0");
-	const unit = (match[2] ?? "bytes").toLowerCase();
-
-	const multipliers: Record<string, number> = {
-		bytes: 1,
-		kib: 1024,
-		mib: 1024 * 1024,
-		gib: 1024 * 1024 * 1024,
-	};
-
-	return Math.round(value * (multipliers[unit] ?? 1));
-}
-
-function parseContributors(output: string): { contributors: string[]; contributor_count: number } {
-	const contributors = output
-		.split("\n")
-		.map((line) => line.trim())
-		.filter((line) => line.length > 0)
-		.map((line) => line.replace(/^\d+\t/, ""));
-
-	return { contributors, contributor_count: contributors.length };
-}
-
-function parseRepoSize(output: string): number {
-	const lines = output.split("\n");
-	let total = 0;
-
-	for (const line of lines) {
-		if (line.startsWith("size:") || line.startsWith("size-pack:")) {
-			const size_str = line.replace(/^size(?:-pack)?:/, "").trim();
-			total += parseSize(size_str);
-		}
-	}
-
-	return total;
-}
-
-function parseTags(output: string): string[] {
-	return output
-		.split("\n")
-		.map((t) => t.trim())
-		.filter((t) => t.length > 0);
-}
-
-function parseRecentCommits(output: string): RecentCommit[] {
-	return output
-		.split("\n")
-		.map((line) => line.trim())
-		.filter((line) => line.length > 0)
-		.map((line) => {
-			const [hash, message, author, time_str] = line.split(":");
-			return {
-				hash: hash ?? "",
-				message: message ?? "",
-				author: author ?? "",
-				time: parseInt(time_str ?? "0", 10),
-			};
-		});
-}
-
-function parseTotalCommits(output: string): number {
-	const n = parseInt(output.trim(), 10);
-	return isNaN(n) ? 0 : n;
-}
-
-export interface CommitActivity {
-	daily_counts: number[];
-	total_this_week: number;
-	total_last_week: number;
-}
-
-function bucketIntoDays(timestamps: number[]): number[] {
-	const now = new Date();
-	const today_start = new Date(now.getFullYear(), now.getMonth(), now.getDate()).getTime();
-	const counts = new Array<number>(14).fill(0);
-
-	for (const ts of timestamps) {
-		const ms = ts * 1000;
-		const days_ago = Math.floor((today_start - ms) / (24 * 60 * 60 * 1000));
-		const index = 13 - days_ago;
-		if (index >= 0 && index < 14) counts[index] = (counts[index] ?? 0) + 1;
-	}
-
-	return counts;
-}
-
-export async function collectCommitActivity(
-	repo_path: string,
-): Promise<Result<CommitActivity, GitStatsError>> {
-	const log_r = await git(["log", "--format=%at", "--since=14 days ago", "--all"], repo_path);
-
-	if (!log_r.ok) return err(log_r.error);
-
-	const timestamps = log_r.value
-		.split("\n")
-		.map((l) => l.trim())
-		.filter((l) => l.length > 0)
-		.map((l) => parseInt(l, 10))
-		.filter((n) => !isNaN(n));
-
-	const daily_counts = bucketIntoDays(timestamps);
-	const total_last_week = daily_counts.slice(0, 7).reduce((a, b) => a + b, 0);
-	const total_this_week = daily_counts.slice(7).reduce((a, b) => a + b, 0);
-
-	return ok({ daily_counts, total_this_week, total_last_week });
-}
-
-export async function collectStats(
-	repoPath: string,
-): Promise<Result<ExtendedStats, GitStatsError>> {
-	const [shortlog_r, count_objects_r, tags_r, log_r, rev_list_r] = await Promise.all([
-		git(["shortlog", "-sn", "--all"], repoPath),
-		git(["count-objects", "-vH"], repoPath),
-		git(["tag", "--list", "--sort=-version:refname"], repoPath),
-		git(["log", "-5", "--format=%h:%s:%an:%at"], repoPath),
-		git(["rev-list", "--count", "HEAD"], repoPath),
-	]);
-
-	// not_a_repo is fatal — check any result for it
-	for (const r of [shortlog_r, count_objects_r, tags_r, log_r, rev_list_r]) {
-		if (!r.ok && r.error.kind === "not_a_repo") return err(r.error);
-	}
-
-	const { contributors, contributor_count } = shortlog_r.ok
-		? parseContributors(shortlog_r.value)
-		: { contributors: [], contributor_count: 0 };
-
-	const repo_size_bytes = count_objects_r.ok
-		? parseRepoSize(count_objects_r.value)
-		: 0;
-
-	const tags = tags_r.ok ? parseTags(tags_r.value) : [];
-
-	const recent_commits = log_r.ok ? parseRecentCommits(log_r.value) : [];
-
-	const total_commits = rev_list_r.ok ? parseTotalCommits(rev_list_r.value) : 0;
-
-	return ok({
-		contributor_count,
-		contributors,
-		repo_size_bytes,
-		tags,
-		recent_commits,
-		total_commits,
-	});
-}

package/packages/core/src/git-status.ts

@@ -1,316 +0,0 @@
-import { ok, err, type Result } from "@f0rbit/corpus";
-import { basename, relative } from "node:path";
-import type {
-	RepoStatus,
-	GitFileChange,
-	BranchInfo,
-	StashEntry,
-	HealthStatus,
-} from "./types";
-
-export type GitStatusError =
-	| { kind: "not_a_repo"; path: string }
-	| { kind: "git_failed"; path: string; command: string; cause: string };
-
-async function git(
-	args: string[],
-	cwd: string,
-): Promise<Result<string, GitStatusError>> {
-	const proc = Bun.spawn(["git", ...args], {
-		cwd,
-		stdout: "pipe",
-		stderr: "pipe",
-	});
-
-	await proc.exited;
-
-	if (proc.exitCode !== 0) {
-		const stderr = await new Response(proc.stderr).text();
-		if (
-			stderr.includes("not a git repository") ||
-			stderr.includes("not a git repo")
-		) {
-			return err({ kind: "not_a_repo", path: cwd });
-		}
-		return err({
-			kind: "git_failed",
-			path: cwd,
-			command: `git ${args.join(" ")}`,
-			cause: stderr.trim(),
-		});
-	}
-
-	const stdout = await new Response(proc.stdout).text();
-	return ok(stdout);
-}
-
-function parseFileStatus(line: string): GitFileChange | null {
-	const first_char = line[0];
-	if (!first_char) return null;
-
-	if (first_char === "?") {
-		const path = line.slice(2);
-		return { path, status: "untracked", staged: false };
-	}
-
-	if (first_char === "u") {
-		const parts = line.split("\t");
-		const path = parts[1] ?? line.split(" ").pop() ?? "";
-		return { path, status: "conflicted", staged: false };
-	}
-
-	if (first_char === "1") {
-		const parts = line.split(" ");
-		const xy = parts[1] ?? "..";
-		const path = line.split("\t")[0]?.split(" ").pop() ?? parts.at(-1) ?? "";
-		const staged = xy[0] !== ".";
-		const status = parseXY(xy);
-		return { path, status, staged };
-	}
-
-	if (first_char === "2") {
-		const tab_parts = line.split("\t");
-		const path = tab_parts[2] ?? tab_parts[1] ?? "";
-		const parts = line.split(" ");
-		const xy = parts[1] ?? "..";
-		const staged = xy[0] !== ".";
-		return { path, status: "renamed", staged };
-	}
-
-	return null;
-}
-
-function parseXY(
-	xy: string,
-): GitFileChange["status"] {
-	const x = xy[0] ?? ".";
-	const y = xy[1] ?? ".";
-	const code = x !== "." ? x : y;
-	switch (code) {
-		case "A":
-			return "added";
-		case "D":
-			return "deleted";
-		case "R":
-			return "renamed";
-		case "C":
-			return "copied";
-		case "M":
-			return "modified";
-		default:
-			return "modified";
-	}
-}
-
-function parseStatusPorcelain(raw: string): {
-	branch: string;
-	ahead: number;
-	behind: number;
-	changes: GitFileChange[];
-} {
-	const lines = raw.split("\n").filter((l) => l.length > 0);
-	let branch = "HEAD";
-	let ahead = 0;
-	let behind = 0;
-	const changes: GitFileChange[] = [];
-
-	for (const line of lines) {
-		if (line.startsWith("# branch.head ")) {
-			branch = line.slice("# branch.head ".length);
-		} else if (line.startsWith("# branch.ab ")) {
-			const match = line.match(/\+(\d+) -(\d+)/);
-			if (match) {
-				ahead = Number.parseInt(match[1] ?? "0", 10);
-				behind = Number.parseInt(match[2] ?? "0", 10);
-			}
-		} else if (line.startsWith("#")) {
-			continue;
-		} else {
-			const change = parseFileStatus(line);
-			if (change) changes.push(change);
-		}
-	}
-
-	return { branch, ahead, behind, changes };
-}
-
-function parseStashList(raw: string): StashEntry[] {
-	return raw
-		.split("\n")
-		.filter((l) => l.length > 0)
-		.map((line) => {
-			const colon_idx = line.indexOf(":");
-			const ref = colon_idx >= 0 ? line.slice(0, colon_idx) : line;
-			const message = colon_idx >= 0 ? line.slice(colon_idx + 1) : "";
-			const index_match = ref.match(/\{(\d+)\}/);
-			return {
-				index: index_match ? Number.parseInt(index_match[1] ?? "0", 10) : 0,
-				message: message.trim(),
-				date: "",
-			};
-		});
-}
-
-function parseBranches(raw: string): {
-	branches: BranchInfo[];
-	local_count: number;
-	remote_count: number;
-} {
-	const names = raw
-		.split("\n")
-		.map((l) => l.trim())
-		.filter((l) => l.length > 0);
-
-	const branches: BranchInfo[] = [];
-	let local_count = 0;
-	let remote_count = 0;
-
-	for (const name of names) {
-		const is_remote = name.includes("/");
-		if (is_remote) {
-			remote_count++;
-		} else {
-			local_count++;
-		}
-		branches.push({
-			name,
-			is_current: false,
-			upstream: null,
-			ahead: 0,
-			behind: 0,
-			last_commit_time: 0,
-		});
-	}
-
-	return { branches, local_count, remote_count };
-}
-
-function deriveHealth(
-	ahead: number,
-	behind: number,
-	modified: number,
-	staged: number,
-	untracked: number,
-	conflicts: number,
-): HealthStatus {
-	if (conflicts > 0) return "conflict";
-	if (ahead > 0 && behind > 0) return "diverged";
-	if (ahead > 0) return "ahead";
-	if (behind > 0) return "behind";
-	if (modified + staged + untracked > 0) return "dirty";
-	return "clean";
-}
-
-export async function collectStatus(
-	repoPath: string,
-	scanRoot: string,
-): Promise<Result<RepoStatus, GitStatusError>> {
-	const [status_result, log_result, stash_result, branches_result, remote_result] =
-		await Promise.all([
-			git(["status", "--porcelain=v2", "--branch"], repoPath),
-			git(["log", "-1", "--format=%H:%s:%at"], repoPath),
-			git(["stash", "list", "--format=%gd:%gs"], repoPath),
-			git(["branch", "-a", "--format=%(refname:short)"], repoPath),
-			git(["remote", "get-url", "origin"], repoPath),
-		]);
-
-	if (!status_result.ok) return status_result;
-	if (!log_result.ok) return log_result;
-	if (!stash_result.ok) return stash_result;
-	if (!branches_result.ok) return branches_result;
-
-	const { branch, ahead, behind, changes } = parseStatusPorcelain(
-		status_result.value,
-	);
-
-	const log_parts = log_result.value.trim().split(":");
-	const head_commit = log_parts[0] ?? "";
-	const head_message = log_parts.slice(1, -1).join(":") ;
-	const head_time = Number.parseInt(log_parts.at(-1) ?? "0", 10);
-
-	const stashes = parseStashList(stash_result.value);
-	const { branches, local_count, remote_count } = parseBranches(
-		branches_result.value,
-	);
-
-	const current_branch =
-		branch === "(detached)" || branch === "HEAD" ? "HEAD (detached)" : branch;
-
-	const current_idx = branches.findIndex(
-		(b) => b.name === current_branch || b.name === branch,
-	);
-	if (current_idx >= 0 && branches[current_idx]) {
-		branches[current_idx].is_current = true;
-	}
-
-	const remote_url = remote_result.ok ? remote_result.value.trim() || null : null;
-
-	const modified_count = changes.filter(
-		(c) => !c.staged && c.status !== "untracked" && c.status !== "conflicted",
-	).length;
-	const staged_count = changes.filter((c) => c.staged).length;
-	const untracked_count = changes.filter(
-		(c) => c.status === "untracked",
-	).length;
-	const conflict_count = changes.filter(
-		(c) => c.status === "conflicted",
-	).length;
-
-	const is_clean =
-		modified_count === 0 &&
-		staged_count === 0 &&
-		untracked_count === 0 &&
-		conflict_count === 0 &&
-		ahead === 0;
-
-	const health = deriveHealth(
-		ahead,
-		behind,
-		modified_count,
-		staged_count,
-		untracked_count,
-		conflict_count,
-	);
-
-	return ok({
-		path: repoPath,
-		name: basename(repoPath),
-		display_path: relative(scanRoot, repoPath),
-
-		current_branch,
-		head_commit,
-		head_message,
-		head_time,
-
-		remote_url,
-		ahead,
-		behind,
-
-		modified_count,
-		staged_count,
-		untracked_count,
-		conflict_count,
-		changes,
-
-		stash_count: stashes.length,
-		stashes,
-
-		branches,
-		local_branch_count: local_count,
-		remote_branch_count: remote_count,
-
-		tags: [],
-		total_commits: 0,
-		repo_size_bytes: 0,
-		contributor_count: 0,
-
-		recent_commits: [],
-
-		commit_activity: null,
-
-		ocn_status: null,
-
-		is_clean,
-		health,
-	});
-}