openclaw/dist/doctor-project-clone-shape-41mIIE52.mjs

Multi-channel AI gateway with extensible messaging integrations

import { t as quoteCliArg } from "./quote-cli-arg-BEt71TUh.mjs";
import { i as executeGitCommand } from "./git-exec-DPoSKq41.mjs";
import { t as note } from "./note-BpWs6H5N.mjs";
import { i as gitEnvironment } from "./git-DOeuOnFt.mjs";
import { t as listProjectRegistry } from "./project-registry-3aLiY1zE.mjs";
//#region src/commands/doctor-project-clone-shape.ts
const CHECK_ID = "core/doctor/project-clone-shape";
function describeCloneConfigKey(key) {
	if (!key.startsWith("remote.")) return {
		name: key,
		urlKey: false
	};
	const fieldOffset = key.lastIndexOf(".");
	const remote = key.slice(7, fieldOffset);
	if (!/(:\/\/|::|@)/.test(remote)) return {
		name: key,
		urlKey: false
	};
	const transport = /^(?:[^:/?#@]+::)+/.exec(remote)?.[0] ?? "";
	let address = remote.slice(transport.length);
	const userInfoEnd = address.lastIndexOf("@");
	if (userInfoEnd >= 0) {
		const schemeEnd = address.indexOf("://");
		const prefixLength = schemeEnd >= 0 && schemeEnd < userInfoEnd ? schemeEnd + 3 : address.startsWith("//") ? 2 : 0;
		address = `${address.slice(0, prefixLength)}***@${address.slice(userInfoEnd + 1)}`;
	}
	address = address.split(/[?#]/, 1)[0] ?? "";
	return {
		name: `remote.${transport}${address}${key.slice(fieldOffset)}`,
		urlKey: true
	};
}
async function readCloneGit(root, args, optional = false) {
	const result = await executeGitCommand(root, args, {
		env: gitEnvironment({
			...process.env,
			GIT_NO_LAZY_FETCH: "1"
		}),
		timeoutMs: 5e3,
		maxOutputBytes: 65536
	});
	if (result.termination !== "exit" || result.stdoutTruncatedBytes || result.code !== 0 && !(optional && result.code === 1)) throw new Error("clone inspection unavailable");
	return result.stdout;
}
async function collectProjectCloneShapeHealthFindings(cfg) {
	const findings = [];
	let projects;
	try {
		projects = (await listProjectRegistry(cfg)).filter((project) => project.source === "cloned");
	} catch {
		return [{
			checkId: CHECK_ID,
			severity: "warning",
			message: "Skipped project clone inspection: the project registry is unreadable.",
			fixHint: "Restore access to the project registry and rerun openclaw doctor."
		}];
	}
	for (const project of projects) try {
		const config = await readCloneGit(project.repoRoot, [
			"config",
			"--null",
			"--name-only",
			"--get-regexp",
			"^remote\\..*\\.(promisor|partialclonefilter)$"
		], true);
		const shallow = (await readCloneGit(project.repoRoot, ["rev-parse", "--is-shallow-repository"])).trim();
		const extension = await readCloneGit(project.repoRoot, [
			"config",
			"--get",
			"extensions.partialclone"
		], true);
		const keys = [...new Set(config.split("\0").filter(Boolean))].toSorted().map(describeCloneConfigKey);
		if (extension) keys.push(describeCloneConfigKey("extensions.partialclone"));
		if (shallow !== "true" && keys.length === 0) continue;
		const unset = (key) => key.urlKey ? [
			`# Before continuing, locate ${key.name} locally; the raw output may contain credentials:`,
			"# git config --get-regexp '^remote\\..*\\.(promisor|partialclonefilter)$'",
			"# Then run: git config --unset-all <the key shown by that command>"
		] : [`git config --unset-all ${quoteCliArg(key.name)}`];
		findings.push({
			checkId: CHECK_ID,
			severity: "warning",
			path: project.repoRoot,
			message: `Project clone ${project.displayName} (${project.id}): shallow=${shallow}; partial-clone keys: ${keys.map((key) => key.name).join(", ") || "none"}. Full clones are recommended for managed worktrees.`,
			fixHint: [
				"Manual repair only (POSIX shell); stop on any failed step:",
				`cd ${quoteCliArg(project.repoRoot)}`,
				...keys.filter((key) => key.name.endsWith(".partialclonefilter")).flatMap(unset),
				`git fetch --refetch${shallow === "true" ? " --unshallow" : ""} origin`,
				"git rev-list --objects --missing=print --all | grep '^?' | cut -c2- | git fetch origin --no-tags --no-write-fetch-head --recurse-submodules=no --stdin",
				...keys.filter((key) => key.name.endsWith(".promisor") || key.name === "extensions.partialclone").flatMap(unset),
				"git repack -a -d",
				"Rerun openclaw doctor. If history or objects remain missing, recover them from the original repository."
			].join("\n")
		});
	} catch {
		findings.push({
			checkId: CHECK_ID,
			severity: "warning",
			path: project.repoRoot,
			message: `Skipped project clone ${project.displayName} (${project.id}): repository is missing, unreadable, or Git inspection did not complete.`,
			fixHint: "Check the clone path, permissions, and Git installation, then rerun openclaw doctor."
		});
	}
	return findings;
}
async function noteProjectCloneShape(cfg) {
	for (const finding of await collectProjectCloneShapeHealthFindings(cfg)) note([
		finding.message,
		finding.path,
		finding.fixHint
	].filter(Boolean).join("\n"), "Project clones");
}
//#endregion
export { collectProjectCloneShapeHealthFindings, noteProjectCloneShape };