bip-skills 1.4.3 → 1.4.5

package/dist/cli.mjs

@@ -29,9 +29,17 @@ const DEFAULT_DISCOVERY_SITE_URL = DEFAULT_WELL_KNOWN_BASE_URL;
 const DEFAULT_SEARCH_API_BASE = DEFAULT_WELL_KNOWN_BASE_URL;
 const DEFAULT_GIT_HOST = "git.yonyou.com";
 const DEFAULT_GIT_BASE_URL = `https://${DEFAULT_GIT_HOST}`;
+const DEFAULT_GIT_FALLBACK_SSH_HOST = "git.yyrd.com";
+const DEFAULT_INSTALL_REPORT_URL = "https://sun.yyuap.com/api/install-report";
 function isYyuapHost(hostname) {
 	return hostname === "yyuap.com" || hostname.endsWith(".yyuap.com");
 }
+function isYyrdHost(hostname) {
+	return hostname === "yyrd.com" || hostname.endsWith(".yyrd.com");
+}
+function isInternalSkillSourceHost(hostname) {
+	return isYyuapHost(hostname) || isYyrdHost(hostname);
+}
 function isAllowedReportingUrl(url) {
 	try {
 		return isYyuapHost(new URL(url).hostname);
@@ -73,6 +81,20 @@ async function isRepoPrivate(owner, repo) {
 		return null;
 	}
 }
+function extractSourceHostname(sourceUrl) {
+	if (sourceUrl.startsWith("http://") || sourceUrl.startsWith("https://") || sourceUrl.startsWith("ssh://") || sourceUrl.startsWith("git://")) try {
+		return new URL(sourceUrl).hostname;
+	} catch {
+		return null;
+	}
+	const scpLikeMatch = sourceUrl.match(/^(?:[^@]+@)?([^:/]+):.+$/);
+	if (scpLikeMatch) return scpLikeMatch[1] ?? null;
+	return null;
+}
+function isInternalSkillSourceUrl(sourceUrl) {
+	const hostname = extractSourceHostname(sourceUrl);
+	return hostname ? isInternalSkillSourceHost(hostname) : false;
+}
 function isLocalPath(input) {
 	return isAbsolute(input) || input.startsWith("./") || input.startsWith("../") || input === "." || input === ".." || /^[a-zA-Z]:[/\\]/.test(input);
 }
@@ -1399,6 +1421,7 @@ function getAllowedReportingUrl(envVarName) {
 }
 const TELEMETRY_URL = getAllowedReportingUrl("SKILLS_TELEMETRY_URL");
 const AUDIT_URL = getAllowedReportingUrl("SKILLS_AUDIT_URL");
+const INSTALL_REPORT_URL = isAllowedReportingUrl(DEFAULT_INSTALL_REPORT_URL) ? DEFAULT_INSTALL_REPORT_URL : null;
 let cliVersion = null;
 function isCI() {
 	return !!(process.env.CI || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI || process.env.CIRCLECI || process.env.TRAVIS || process.env.BUILDKITE || process.env.JENKINS_URL || process.env.TEAMCITY_VERSION);
@@ -1427,17 +1450,24 @@ async function fetchAuditData(source, skillSlugs, timeoutMs = 3e3) {
 		return null;
 	}
 }
-function track(data) {
-	if (!TELEMETRY_URL) return;
+function sendTelemetry(url, data) {
 	if (!isEnabled()) return;
 	try {
 		const params = new URLSearchParams();
 		if (cliVersion) params.set("v", cliVersion);
 		if (isCI()) params.set("ci", "1");
 		for (const [key, value] of Object.entries(data)) if (value !== void 0 && value !== null) params.set(key, String(value));
-		fetch(`${TELEMETRY_URL}?${params.toString()}`).catch(() => {});
+		fetch(`${url}?${params.toString()}`).catch(() => {});
 	} catch {}
 }
+function track(data) {
+	if (!TELEMETRY_URL) return;
+	sendTelemetry(TELEMETRY_URL, data);
+}
+function trackInstallReport(data) {
+	if (!INSTALL_REPORT_URL) return;
+	sendTelemetry(INSTALL_REPORT_URL, data);
+}
 var ProviderRegistryImpl = class {
 	providers = [];
 	register(provider) {
@@ -1476,15 +1506,16 @@ var WellKnownProvider = class {
 			return { matches: false };
 		}
 	}
-	async fetchIndex(baseUrl) {
+	async fetchIndex(baseUrl, options = {}) {
 		try {
+			const { fallbackToRoot = true } = options;
 			const parsed = new URL(baseUrl);
 			const basePath = parsed.pathname.replace(/\/$/, "");
 			const urlsToTry = [{
 				indexUrl: `${parsed.protocol}//${parsed.host}${basePath}/${this.WELL_KNOWN_PATH}/${this.INDEX_FILE}`,
 				baseUrl: `${parsed.protocol}//${parsed.host}${basePath}`
 			}];
-			if (basePath && basePath !== "") urlsToTry.push({
+			if (fallbackToRoot && basePath && basePath !== "") urlsToTry.push({
 				indexUrl: `${parsed.protocol}//${parsed.host}/${this.WELL_KNOWN_PATH}/${this.INDEX_FILE}`,
 				baseUrl: `${parsed.protocol}//${parsed.host}`
 			});
@@ -1532,10 +1563,10 @@ var WellKnownProvider = class {
 		if (!e.files.some((f) => typeof f === "string" && f.toLowerCase() === "skill.md")) return false;
 		return true;
 	}
-	async fetchSkill(url) {
+	async fetchSkill(url, options = {}) {
 		try {
 			const parsed = new URL(url);
-			const result = await this.fetchIndex(url);
+			const result = await this.fetchIndex(url, options);
 			if (!result) return null;
 			const { index, resolvedBaseUrl } = result;
 			let skillName = null;
@@ -1588,9 +1619,9 @@ var WellKnownProvider = class {
 			return null;
 		}
 	}
-	async fetchAllSkills(url) {
+	async fetchAllSkills(url, options = {}) {
 		try {
-			const result = await this.fetchIndex(url);
+			const result = await this.fetchIndex(url, options);
 			if (!result) return [];
 			const { index, resolvedBaseUrl } = result;
 			const skillPromises = index.skills.map((entry) => this.fetchSkillByEntry(resolvedBaseUrl, entry));
@@ -1621,8 +1652,8 @@ var WellKnownProvider = class {
 			return "unknown";
 		}
 	}
-	async hasSkillsIndex(url) {
-		return await this.fetchIndex(url) !== null;
+	async hasSkillsIndex(url, options = {}) {
+		return await this.fetchIndex(url, options) !== null;
 	}
 };
 const wellKnownProvider = new WellKnownProvider();
@@ -1802,7 +1833,7 @@ function createEmptyLocalLock() {
 		skills: {}
 	};
 }
-var version$1 = "1.4.3";
+var version$1 = "1.4.5";
 const isCancelled$1 = (value) => typeof value === "symbol";
 async function isSourcePrivate(source) {
 	const ownerRepo = parseOwnerRepo(source);
@@ -1968,304 +1999,364 @@ async function selectAgentsInteractive(options) {
 	return selected;
 }
 setVersion(version$1);
+function resolveInstallOutcome(successCount, failCount) {
+	if (failCount === 0) return "success";
+	if (successCount === 0) return "failure";
+	return "partial_failure";
+}
+function buildFailedDetails(results) {
+	const failed = results.filter((result) => !result.success).map((result) => `${result.skill}@${result.agent}${result.error ? `:${result.error}` : ""}`);
+	return failed.length > 0 ? JSON.stringify(failed) : void 0;
+}
+function reportInstallToSunIfNeeded(params) {
+	if (!isInternalSkillSourceUrl(params.sourceUrl)) return;
+	trackInstallReport({
+		event: "install",
+		source: params.source,
+		sourceUrl: params.sourceUrl,
+		skills: params.skills.join(","),
+		agents: params.agents.join(","),
+		...params.installGlobally && { global: "1" },
+		...params.skillFiles && { skillFiles: JSON.stringify(params.skillFiles) },
+		...params.sourceType && { sourceType: params.sourceType },
+		result: resolveInstallOutcome(params.successfulCount, params.failedCount),
+		successCount: String(params.successfulCount),
+		failCount: String(params.failedCount),
+		...params.failedDetails && { failedDetails: params.failedDetails },
+		...params.errorMessage && { errorMessage: params.errorMessage }
+	});
+}
 function isBareSkillNameSource(source) {
 	return /^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$/.test(source);
 }
 function shouldProbeDefaultWellKnownPath(source) {
 	return source.includes("/") && !source.includes("@") && !source.startsWith("http://") && !source.startsWith("https://") && !source.startsWith("git@") && !source.startsWith("ssh://") && !source.startsWith("./") && !source.startsWith("../") && source !== "." && source !== "..";
 }
-async function handleWellKnownSkills(source, url, options, spinner, allowFallback = false) {
-	spinner.start("Discovering skills from well-known endpoint...");
-	const skills = await wellKnownProvider.fetchAllSkills(url);
-	if (skills.length === 0) {
-		if (allowFallback) {
-			spinner.stop(import_picocolors.default.yellow("Default well-known endpoint unavailable"));
-			return false;
-		}
-		spinner.stop(import_picocolors.default.red("No skills found"));
-		Se(import_picocolors.default.red("No skills found at this URL. Make sure the server has a /.well-known/skills/index.json file."));
-		process.exit(1);
-	}
-	spinner.stop(`Found ${import_picocolors.default.green(skills.length)} skill${skills.length > 1 ? "s" : ""}`);
-	for (const skill of skills) {
-		M.info(`Skill: ${import_picocolors.default.cyan(skill.installName)}`);
-		M.message(import_picocolors.default.dim(skill.description));
-		if (skill.files.size > 1) M.message(import_picocolors.default.dim(`  Files: ${Array.from(skill.files.keys()).join(", ")}`));
-	}
-	if (options.list) {
-		console.log();
-		M.step(import_picocolors.default.bold("Available Skills"));
-		for (const skill of skills) {
-			M.message(`  ${import_picocolors.default.cyan(skill.installName)}`);
-			M.message(`    ${import_picocolors.default.dim(skill.description)}`);
-			if (skill.files.size > 1) M.message(`    ${import_picocolors.default.dim(`Files: ${skill.files.size}`)}`);
-		}
-		console.log();
-		Se("Run without --list to install");
-		process.exit(0);
-	}
-	let selectedSkills;
-	if (options.skill?.includes("*")) {
-		selectedSkills = skills;
-		M.info(`Installing all ${skills.length} skills`);
-	} else if (options.skill && options.skill.length > 0) {
-		selectedSkills = skills.filter((s) => options.skill.some((name) => s.installName.toLowerCase() === name.toLowerCase() || s.name.toLowerCase() === name.toLowerCase()));
-		if (selectedSkills.length === 0) {
+function buildFallbackGitSshUrl(source) {
+	return `git@${DEFAULT_GIT_FALLBACK_SSH_HOST}:${source.replace(/\.git$/, "")}.git`;
+}
+async function handleWellKnownSkills(source, url, options, spinner, allowFallback = false, fallbackToRoot = true) {
+	const shouldReportToSun = isInternalSkillSourceUrl(url);
+	try {
+		spinner.start("Discovering skills from well-known endpoint...");
+		const skills = await wellKnownProvider.fetchAllSkills(url, { fallbackToRoot });
+		if (skills.length === 0) {
 			if (allowFallback) {
-				M.info(`Skill not found on default well-known endpoint: ${options.skill.join(", ")}`);
+				spinner.stop(import_picocolors.default.yellow("Default well-known endpoint unavailable"));
 				return false;
 			}
-			M.error(`No matching skills found for: ${options.skill.join(", ")}`);
-			M.info("Available skills:");
-			for (const s of skills) M.message(`  - ${s.installName}`);
+			spinner.stop(import_picocolors.default.red("No skills found"));
+			Se(import_picocolors.default.red("No skills found at this URL. Make sure the server has a /.well-known/skills/index.json file."));
 			process.exit(1);
 		}
-	} else if (skills.length === 1) {
-		selectedSkills = skills;
-		const firstSkill = skills[0];
-		M.info(`Skill: ${import_picocolors.default.cyan(firstSkill.installName)}`);
-	} else if (options.yes) {
-		selectedSkills = skills;
-		M.info(`Installing all ${skills.length} skills`);
-	} else {
-		const selected = await multiselect({
-			message: "Select skills to install",
-			options: skills.map((s) => ({
-				value: s,
-				label: s.installName,
-				hint: s.description.length > 60 ? s.description.slice(0, 57) + "..." : s.description
-			})),
-			required: true
-		});
-		if (pD(selected)) {
-			xe("Installation cancelled");
-			process.exit(0);
+		spinner.stop(`Found ${import_picocolors.default.green(skills.length)} skill${skills.length > 1 ? "s" : ""}`);
+		for (const skill of skills) {
+			M.info(`Skill: ${import_picocolors.default.cyan(skill.installName)}`);
+			M.message(import_picocolors.default.dim(skill.description));
+			if (skill.files.size > 1) M.message(import_picocolors.default.dim(`  Files: ${Array.from(skill.files.keys()).join(", ")}`));
 		}
-		selectedSkills = selected;
-	}
-	let targetAgents;
-	const validAgents = Object.keys(agents);
-	if (options.agent?.includes("*")) {
-		targetAgents = validAgents;
-		M.info(`Installing to all ${targetAgents.length} agents`);
-	} else if (options.agent && options.agent.length > 0) {
-		const invalidAgents = options.agent.filter((a) => !validAgents.includes(a));
-		if (invalidAgents.length > 0) {
-			M.error(`Invalid agents: ${invalidAgents.join(", ")}`);
-			M.info(`Valid agents: ${validAgents.join(", ")}`);
-			process.exit(1);
+		if (options.list) {
+			console.log();
+			M.step(import_picocolors.default.bold("Available Skills"));
+			for (const skill of skills) {
+				M.message(`  ${import_picocolors.default.cyan(skill.installName)}`);
+				M.message(`    ${import_picocolors.default.dim(skill.description)}`);
+				if (skill.files.size > 1) M.message(`    ${import_picocolors.default.dim(`Files: ${skill.files.size}`)}`);
+			}
+			console.log();
+			Se("Run without --list to install");
+			process.exit(0);
 		}
-		targetAgents = options.agent;
-	} else {
-		spinner.start("Loading agents...");
-		const installedAgents = await detectInstalledAgents();
-		const totalAgents = Object.keys(agents).length;
-		spinner.stop(`${totalAgents} agents`);
-		if (installedAgents.length === 0) if (options.yes) {
-			targetAgents = validAgents;
-			M.info("Installing to all agents");
+		let selectedSkills;
+		if (options.skill?.includes("*")) {
+			selectedSkills = skills;
+			M.info(`Installing all ${skills.length} skills`);
+		} else if (options.skill && options.skill.length > 0) {
+			selectedSkills = skills.filter((s) => options.skill.some((name) => s.installName.toLowerCase() === name.toLowerCase() || s.name.toLowerCase() === name.toLowerCase()));
+			if (selectedSkills.length === 0) {
+				if (allowFallback) {
+					M.info(`Skill not found on default well-known endpoint: ${options.skill.join(", ")}`);
+					return false;
+				}
+				M.error(`No matching skills found for: ${options.skill.join(", ")}`);
+				M.info("Available skills:");
+				for (const s of skills) M.message(`  - ${s.installName}`);
+				process.exit(1);
+			}
+		} else if (skills.length === 1) {
+			selectedSkills = skills;
+			const firstSkill = skills[0];
+			M.info(`Skill: ${import_picocolors.default.cyan(firstSkill.installName)}`);
+		} else if (options.yes) {
+			selectedSkills = skills;
+			M.info(`Installing all ${skills.length} skills`);
 		} else {
-			M.info("Select agents to install skills to");
-			const selected = await promptForAgents("Which agents do you want to install to?", Object.entries(agents).map(([key, config]) => ({
-				value: key,
-				label: config.displayName
-			})));
+			const selected = await multiselect({
+				message: "Select skills to install",
+				options: skills.map((s) => ({
+					value: s,
+					label: s.installName,
+					hint: s.description.length > 60 ? s.description.slice(0, 57) + "..." : s.description
+				})),
+				required: true
+			});
 			if (pD(selected)) {
 				xe("Installation cancelled");
 				process.exit(0);
 			}
-			targetAgents = selected;
+			selectedSkills = selected;
 		}
-		else if (installedAgents.length === 1 || options.yes) {
-			targetAgents = ensureUniversalAgents(installedAgents);
-			if (installedAgents.length === 1) {
-				const firstAgent = installedAgents[0];
-				M.info(`Installing to: ${import_picocolors.default.cyan(agents[firstAgent].displayName)}`);
-			} else M.info(`Installing to: ${installedAgents.map((a) => import_picocolors.default.cyan(agents[a].displayName)).join(", ")}`);
+		let targetAgents;
+		const validAgents = Object.keys(agents);
+		if (options.agent?.includes("*")) {
+			targetAgents = validAgents;
+			M.info(`Installing to all ${targetAgents.length} agents`);
+		} else if (options.agent && options.agent.length > 0) {
+			const invalidAgents = options.agent.filter((a) => !validAgents.includes(a));
+			if (invalidAgents.length > 0) {
+				M.error(`Invalid agents: ${invalidAgents.join(", ")}`);
+				M.info(`Valid agents: ${validAgents.join(", ")}`);
+				process.exit(1);
+			}
+			targetAgents = options.agent;
 		} else {
-			const selected = await selectAgentsInteractive({ global: options.global });
-			if (pD(selected)) {
+			spinner.start("Loading agents...");
+			const installedAgents = await detectInstalledAgents();
+			const totalAgents = Object.keys(agents).length;
+			spinner.stop(`${totalAgents} agents`);
+			if (installedAgents.length === 0) if (options.yes) {
+				targetAgents = validAgents;
+				M.info("Installing to all agents");
+			} else {
+				M.info("Select agents to install skills to");
+				const selected = await promptForAgents("Which agents do you want to install to?", Object.entries(agents).map(([key, config]) => ({
+					value: key,
+					label: config.displayName
+				})));
+				if (pD(selected)) {
+					xe("Installation cancelled");
+					process.exit(0);
+				}
+				targetAgents = selected;
+			}
+			else if (installedAgents.length === 1 || options.yes) {
+				targetAgents = ensureUniversalAgents(installedAgents);
+				if (installedAgents.length === 1) {
+					const firstAgent = installedAgents[0];
+					M.info(`Installing to: ${import_picocolors.default.cyan(agents[firstAgent].displayName)}`);
+				} else M.info(`Installing to: ${installedAgents.map((a) => import_picocolors.default.cyan(agents[a].displayName)).join(", ")}`);
+			} else {
+				const selected = await selectAgentsInteractive({ global: options.global });
+				if (pD(selected)) {
+					xe("Installation cancelled");
+					process.exit(0);
+				}
+				targetAgents = selected;
+			}
+		}
+		let installGlobally = options.global ?? false;
+		const supportsGlobal = targetAgents.some((a) => agents[a].globalSkillsDir !== void 0);
+		if (options.global === void 0 && !options.yes && supportsGlobal) {
+			const scope = await ve({
+				message: "Installation scope",
+				options: [{
+					value: false,
+					label: "Project",
+					hint: "Install in current directory (committed with your project)"
+				}, {
+					value: true,
+					label: "Global",
+					hint: "Install in home directory (available across all projects)"
+				}]
+			});
+			if (pD(scope)) {
 				xe("Installation cancelled");
 				process.exit(0);
 			}
-			targetAgents = selected;
+			installGlobally = scope;
 		}
-	}
-	let installGlobally = options.global ?? false;
-	const supportsGlobal = targetAgents.some((a) => agents[a].globalSkillsDir !== void 0);
-	if (options.global === void 0 && !options.yes && supportsGlobal) {
-		const scope = await ve({
-			message: "Installation scope",
-			options: [{
-				value: false,
-				label: "Project",
-				hint: "Install in current directory (committed with your project)"
-			}, {
-				value: true,
-				label: "Global",
-				hint: "Install in home directory (available across all projects)"
-			}]
-		});
-		if (pD(scope)) {
-			xe("Installation cancelled");
-			process.exit(0);
+		let installMode = options.copy ? "copy" : "symlink";
+		if (!options.copy && !options.yes) {
+			const modeChoice = await ve({
+				message: "Installation method",
+				options: [{
+					value: "symlink",
+					label: "Symlink (Recommended)",
+					hint: "Single source of truth, easy updates"
+				}, {
+					value: "copy",
+					label: "Copy to all agents",
+					hint: "Independent copies for each agent"
+				}]
+			});
+			if (pD(modeChoice)) {
+				xe("Installation cancelled");
+				process.exit(0);
+			}
+			installMode = modeChoice;
 		}
-		installGlobally = scope;
-	}
-	let installMode = options.copy ? "copy" : "symlink";
-	if (!options.copy && !options.yes) {
-		const modeChoice = await ve({
-			message: "Installation method",
-			options: [{
-				value: "symlink",
-				label: "Symlink (Recommended)",
-				hint: "Single source of truth, easy updates"
-			}, {
-				value: "copy",
-				label: "Copy to all agents",
-				hint: "Independent copies for each agent"
-			}]
-		});
-		if (pD(modeChoice)) {
-			xe("Installation cancelled");
-			process.exit(0);
+		const cwd = process.cwd();
+		const summaryLines = [];
+		targetAgents.map((a) => agents[a].displayName);
+		const overwriteChecks = await Promise.all(selectedSkills.flatMap((skill) => targetAgents.map(async (agent) => ({
+			skillName: skill.installName,
+			agent,
+			installed: await isSkillInstalled(skill.installName, agent, { global: installGlobally })
+		}))));
+		const overwriteStatus = /* @__PURE__ */ new Map();
+		for (const { skillName, agent, installed } of overwriteChecks) {
+			if (!overwriteStatus.has(skillName)) overwriteStatus.set(skillName, /* @__PURE__ */ new Map());
+			overwriteStatus.get(skillName).set(agent, installed);
 		}
-		installMode = modeChoice;
-	}
-	const cwd = process.cwd();
-	const summaryLines = [];
-	targetAgents.map((a) => agents[a].displayName);
-	const overwriteChecks = await Promise.all(selectedSkills.flatMap((skill) => targetAgents.map(async (agent) => ({
-		skillName: skill.installName,
-		agent,
-		installed: await isSkillInstalled(skill.installName, agent, { global: installGlobally })
-	}))));
-	const overwriteStatus = /* @__PURE__ */ new Map();
-	for (const { skillName, agent, installed } of overwriteChecks) {
-		if (!overwriteStatus.has(skillName)) overwriteStatus.set(skillName, /* @__PURE__ */ new Map());
-		overwriteStatus.get(skillName).set(agent, installed);
-	}
-	for (const skill of selectedSkills) {
-		if (summaryLines.length > 0) summaryLines.push("");
-		const shortCanonical = shortenPath$2(getCanonicalPath(skill.installName, { global: installGlobally }), cwd);
-		summaryLines.push(`${import_picocolors.default.cyan(shortCanonical)}`);
-		summaryLines.push(...buildAgentSummaryLines(targetAgents, installMode));
-		if (skill.files.size > 1) summaryLines.push(`  ${import_picocolors.default.dim("files:")} ${skill.files.size}`);
-		const skillOverwrites = overwriteStatus.get(skill.installName);
-		const overwriteAgents = targetAgents.filter((a) => skillOverwrites?.get(a)).map((a) => agents[a].displayName);
-		if (overwriteAgents.length > 0) summaryLines.push(`  ${import_picocolors.default.yellow("overwrites:")} ${formatList$1(overwriteAgents)}`);
-	}
-	console.log();
-	Me(summaryLines.join("\n"), "Installation Summary");
-	if (!options.yes) {
-		const confirmed = await ye({ message: "Proceed with installation?" });
-		if (pD(confirmed) || !confirmed) {
-			xe("Installation cancelled");
-			process.exit(0);
+		for (const skill of selectedSkills) {
+			if (summaryLines.length > 0) summaryLines.push("");
+			const shortCanonical = shortenPath$2(getCanonicalPath(skill.installName, { global: installGlobally }), cwd);
+			summaryLines.push(`${import_picocolors.default.cyan(shortCanonical)}`);
+			summaryLines.push(...buildAgentSummaryLines(targetAgents, installMode));
+			if (skill.files.size > 1) summaryLines.push(`  ${import_picocolors.default.dim("files:")} ${skill.files.size}`);
+			const skillOverwrites = overwriteStatus.get(skill.installName);
+			const overwriteAgents = targetAgents.filter((a) => skillOverwrites?.get(a)).map((a) => agents[a].displayName);
+			if (overwriteAgents.length > 0) summaryLines.push(`  ${import_picocolors.default.yellow("overwrites:")} ${formatList$1(overwriteAgents)}`);
 		}
-	}
-	spinner.start("Installing skills...");
-	const results = [];
-	for (const skill of selectedSkills) for (const agent of targetAgents) {
-		const result = await installWellKnownSkillForAgent(skill, agent, {
-			global: installGlobally,
-			mode: installMode
+		console.log();
+		Me(summaryLines.join("\n"), "Installation Summary");
+		if (!options.yes) {
+			const confirmed = await ye({ message: "Proceed with installation?" });
+			if (pD(confirmed) || !confirmed) {
+				xe("Installation cancelled");
+				process.exit(0);
+			}
+		}
+		spinner.start("Installing skills...");
+		const results = [];
+		for (const skill of selectedSkills) for (const agent of targetAgents) {
+			const result = await installWellKnownSkillForAgent(skill, agent, {
+				global: installGlobally,
+				mode: installMode
+			});
+			results.push({
+				skill: skill.installName,
+				agent: agents[agent].displayName,
+				...result
+			});
+		}
+		spinner.stop("Installation complete");
+		console.log();
+		const successful = results.filter((r) => r.success);
+		const failed = results.filter((r) => !r.success);
+		const sourceIdentifier = wellKnownProvider.getSourceIdentifier(url);
+		const skillFiles = {};
+		for (const skill of selectedSkills) skillFiles[skill.installName] = skill.sourceUrl;
+		if (await isSourcePrivate(sourceIdentifier) !== true) track({
+			event: "install",
+			source: sourceIdentifier,
+			skills: selectedSkills.map((s) => s.installName).join(","),
+			agents: targetAgents.join(","),
+			...installGlobally && { global: "1" },
+			skillFiles: JSON.stringify(skillFiles),
+			sourceType: "well-known"
 		});
-		results.push({
-			skill: skill.installName,
-			agent: agents[agent].displayName,
-			...result
+		reportInstallToSunIfNeeded({
+			source: sourceIdentifier,
+			sourceUrl: url,
+			skills: selectedSkills.map((s) => s.installName),
+			agents: targetAgents,
+			installGlobally,
+			skillFiles,
+			sourceType: "well-known",
+			successfulCount: successful.length,
+			failedCount: failed.length,
+			failedDetails: buildFailedDetails(results)
 		});
-	}
-	spinner.stop("Installation complete");
-	console.log();
-	const successful = results.filter((r) => r.success);
-	const failed = results.filter((r) => !r.success);
-	const sourceIdentifier = wellKnownProvider.getSourceIdentifier(url);
-	const skillFiles = {};
-	for (const skill of selectedSkills) skillFiles[skill.installName] = skill.sourceUrl;
-	if (await isSourcePrivate(sourceIdentifier) !== true) track({
-		event: "install",
-		source: sourceIdentifier,
-		skills: selectedSkills.map((s) => s.installName).join(","),
-		agents: targetAgents.join(","),
-		...installGlobally && { global: "1" },
-		skillFiles: JSON.stringify(skillFiles),
-		sourceType: "well-known"
-	});
-	if (successful.length > 0 && installGlobally) {
-		const successfulSkillNames = new Set(successful.map((r) => r.skill));
-		for (const skill of selectedSkills) if (successfulSkillNames.has(skill.installName)) try {
-			await addSkillToLock(skill.installName, {
-				source: sourceIdentifier,
-				sourceType: "well-known",
-				sourceUrl: skill.sourceUrl,
-				skillFolderHash: ""
-			});
-		} catch {}
-	}
-	if (successful.length > 0 && !installGlobally) {
-		const successfulSkillNames = new Set(successful.map((r) => r.skill));
-		for (const skill of selectedSkills) if (successfulSkillNames.has(skill.installName)) try {
-			const matchingResult = successful.find((r) => r.skill === skill.installName);
-			const installDir = matchingResult?.canonicalPath || matchingResult?.path;
-			if (installDir) {
-				const computedHash = await computeSkillFolderHash(installDir);
-				await addSkillToLocalLock(skill.installName, {
+		if (successful.length > 0 && installGlobally) {
+			const successfulSkillNames = new Set(successful.map((r) => r.skill));
+			for (const skill of selectedSkills) if (successfulSkillNames.has(skill.installName)) try {
+				await addSkillToLock(skill.installName, {
 					source: sourceIdentifier,
 					sourceType: "well-known",
-					computedHash
-				}, cwd);
-			}
-		} catch {}
-	}
-	if (successful.length > 0) {
-		const bySkill = /* @__PURE__ */ new Map();
-		for (const r of successful) {
-			const skillResults = bySkill.get(r.skill) || [];
-			skillResults.push(r);
-			bySkill.set(r.skill, skillResults);
+					sourceUrl: skill.sourceUrl,
+					skillFolderHash: ""
+				});
+			} catch {}
 		}
-		const skillCount = bySkill.size;
-		const symlinkFailures = successful.filter((r) => r.mode === "symlink" && r.symlinkFailed);
-		const copiedAgents = symlinkFailures.map((r) => r.agent);
-		const resultLines = [];
-		for (const [skillName, skillResults] of bySkill) {
-			const firstResult = skillResults[0];
-			if (firstResult.mode === "copy") {
-				resultLines.push(`${import_picocolors.default.green("✓")} ${skillName} ${import_picocolors.default.dim("(copied)")}`);
-				for (const r of skillResults) {
-					const shortPath = shortenPath$2(r.path, cwd);
-					resultLines.push(`  ${import_picocolors.default.dim("→")} ${shortPath}`);
+		if (successful.length > 0 && !installGlobally) {
+			const successfulSkillNames = new Set(successful.map((r) => r.skill));
+			for (const skill of selectedSkills) if (successfulSkillNames.has(skill.installName)) try {
+				const matchingResult = successful.find((r) => r.skill === skill.installName);
+				const installDir = matchingResult?.canonicalPath || matchingResult?.path;
+				if (installDir) {
+					const computedHash = await computeSkillFolderHash(installDir);
+					await addSkillToLocalLock(skill.installName, {
+						source: sourceIdentifier,
+						sourceType: "well-known",
+						computedHash
+					}, cwd);
 				}
-			} else {
-				if (firstResult.canonicalPath) {
-					const shortPath = shortenPath$2(firstResult.canonicalPath, cwd);
-					resultLines.push(`${import_picocolors.default.green("✓")} ${shortPath}`);
-				} else resultLines.push(`${import_picocolors.default.green("✓")} ${skillName}`);
-				resultLines.push(...buildResultLines(skillResults, targetAgents));
+			} catch {}
+		}
+		if (successful.length > 0) {
+			const bySkill = /* @__PURE__ */ new Map();
+			for (const r of successful) {
+				const skillResults = bySkill.get(r.skill) || [];
+				skillResults.push(r);
+				bySkill.set(r.skill, skillResults);
+			}
+			const skillCount = bySkill.size;
+			const symlinkFailures = successful.filter((r) => r.mode === "symlink" && r.symlinkFailed);
+			const copiedAgents = symlinkFailures.map((r) => r.agent);
+			const resultLines = [];
+			for (const [skillName, skillResults] of bySkill) {
+				const firstResult = skillResults[0];
+				if (firstResult.mode === "copy") {
+					resultLines.push(`${import_picocolors.default.green("✓")} ${skillName} ${import_picocolors.default.dim("(copied)")}`);
+					for (const r of skillResults) {
+						const shortPath = shortenPath$2(r.path, cwd);
+						resultLines.push(`  ${import_picocolors.default.dim("→")} ${shortPath}`);
+					}
+				} else {
+					if (firstResult.canonicalPath) {
+						const shortPath = shortenPath$2(firstResult.canonicalPath, cwd);
+						resultLines.push(`${import_picocolors.default.green("✓")} ${shortPath}`);
+					} else resultLines.push(`${import_picocolors.default.green("✓")} ${skillName}`);
+					resultLines.push(...buildResultLines(skillResults, targetAgents));
+				}
+			}
+			const title = import_picocolors.default.green(`Installed ${skillCount} skill${skillCount !== 1 ? "s" : ""}`);
+			Me(resultLines.join("\n"), title);
+			if (symlinkFailures.length > 0) {
+				M.warn(import_picocolors.default.yellow(`Symlinks failed for: ${formatList$1(copiedAgents)}`));
+				M.message(import_picocolors.default.dim("  Files were copied instead. On Windows, enable Developer Mode for symlink support."));
 			}
 		}
-		const title = import_picocolors.default.green(`Installed ${skillCount} skill${skillCount !== 1 ? "s" : ""}`);
-		Me(resultLines.join("\n"), title);
-		if (symlinkFailures.length > 0) {
-			M.warn(import_picocolors.default.yellow(`Symlinks failed for: ${formatList$1(copiedAgents)}`));
-			M.message(import_picocolors.default.dim("  Files were copied instead. On Windows, enable Developer Mode for symlink support."));
+		if (failed.length > 0) {
+			console.log();
+			M.error(import_picocolors.default.red(`Failed to install ${failed.length}`));
+			for (const r of failed) M.message(`  ${import_picocolors.default.red("✗")} ${r.skill} → ${r.agent}: ${import_picocolors.default.dim(r.error)}`);
 		}
-	}
-	if (failed.length > 0) {
 		console.log();
-		M.error(import_picocolors.default.red(`Failed to install ${failed.length}`));
-		for (const r of failed) M.message(`  ${import_picocolors.default.red("✗")} ${r.skill} → ${r.agent}: ${import_picocolors.default.dim(r.error)}`);
+		Se(import_picocolors.default.green("Done!") + import_picocolors.default.dim("  Review skills before use; they run with full agent permissions."));
+		await promptForFindSkills(options, targetAgents);
+		return true;
+	} catch (error) {
+		if (shouldReportToSun) reportInstallToSunIfNeeded({
+			source: wellKnownProvider.getSourceIdentifier(url),
+			sourceUrl: url,
+			skills: options.skill || [],
+			agents: options.agent || [],
+			installGlobally: options.global ?? false,
+			sourceType: "well-known",
+			successfulCount: 0,
+			failedCount: 1,
+			errorMessage: error instanceof Error ? error.message : "Unknown error occurred"
+		});
+		throw error;
 	}
-	console.log();
-	Se(import_picocolors.default.green("Done!") + import_picocolors.default.dim("  Review skills before use; they run with full agent permissions."));
-	await promptForFindSkills(options, targetAgents);
-	return true;
 }
 async function runAdd(args, options = {}) {
 	let source = args[0] || DEFAULT_WELL_KNOWN_BASE_URL;
 	let installTipShown = false;
+	let parsed = null;
+	let installReportContext = null;
 	const showInstallTip = () => {
 		if (installTipShown) return;
 		M.message(import_picocolors.default.dim("Tip: use the --yes (-y) and --global (-g) flags to install without prompts."));
@@ -2285,16 +2376,17 @@ async function runAdd(args, options = {}) {
 		if (source && isBareSkillNameSource(source)) {
 			options.skill = options.skill || [];
 			if (!options.skill.includes(source)) options.skill.push(source);
-			if (await handleWellKnownSkills(source, DEFAULT_WELL_KNOWN_BASE_URL, options, spinner, true)) return;
+			if (await handleWellKnownSkills(source, DEFAULT_WELL_KNOWN_BASE_URL, options, spinner, true, true)) return;
 			Se(import_picocolors.default.red(`No skills found for: ${source}`));
 			process.exit(1);
 		}
 		if (source && shouldProbeDefaultWellKnownPath(source)) {
-			if (await handleWellKnownSkills(source, `${DEFAULT_WELL_KNOWN_BASE_URL}/${source.replace(/^\/+/, "")}`, options, spinner, true)) return;
-			M.info(`Falling back to source parsing: ${import_picocolors.default.cyan(source)}`);
+			if (await handleWellKnownSkills(source, `${DEFAULT_WELL_KNOWN_BASE_URL}/${source.replace(/^\/+/, "")}`, options, spinner, true, false)) return;
+			source = buildFallbackGitSshUrl(source);
+			M.info(`Falling back to git source: ${import_picocolors.default.cyan(source)}`);
 		}
 		spinner.start("Parsing source...");
-		const parsed = parseSource(source);
+		parsed = parseSource(source);
 		spinner.stop(`Source: ${parsed.type === "local" ? parsed.localPath : parsed.url}${parsed.ref ? ` @ ${import_picocolors.default.yellow(parsed.ref)}` : ""}${parsed.subpath ? ` (${parsed.subpath})` : ""}${parsed.skillFilter ? ` ${import_picocolors.default.dim("@")}${import_picocolors.default.cyan(parsed.skillFilter)}` : ""}`);
 		if (parsed.skillFilter) {
 			options.skill = options.skill || [];
@@ -2617,6 +2709,15 @@ async function runAdd(args, options = {}) {
 			skillFiles[skill.name] = relativePath;
 		}
 		const normalizedSource = getOwnerRepo(parsed);
+		installReportContext = {
+			source: normalizedSource || parsed.url,
+			sourceUrl: parsed.url,
+			skills: selectedSkills.map((s) => s.name),
+			agents: targetAgents,
+			installGlobally,
+			sourceType: parsed.type,
+			skillFiles
+		};
 		if (normalizedSource) {
 			const ownerRepo = parseOwnerRepo(normalizedSource);
 			if (ownerRepo) {
@@ -2637,6 +2738,18 @@ async function runAdd(args, options = {}) {
 				skillFiles: JSON.stringify(skillFiles)
 			});
 		}
+		reportInstallToSunIfNeeded({
+			source: installReportContext.source,
+			sourceUrl: installReportContext.sourceUrl,
+			skills: installReportContext.skills,
+			agents: installReportContext.agents,
+			installGlobally: installReportContext.installGlobally,
+			sourceType: installReportContext.sourceType,
+			skillFiles: installReportContext.skillFiles,
+			successfulCount: successful.length,
+			failedCount: failed.length,
+			failedDetails: buildFailedDetails(results)
+		});
 		if (successful.length > 0 && installGlobally && normalizedSource) {
 			const successfulSkillNames = new Set(successful.map((r) => r.skill));
 			for (const skill of selectedSkills) {
@@ -2740,6 +2853,18 @@ async function runAdd(args, options = {}) {
 		Se(import_picocolors.default.green("Done!") + import_picocolors.default.dim("  Review skills before use; they run with full agent permissions."));
 		await promptForFindSkills(options, targetAgents);
 	} catch (error) {
+		if (parsed) reportInstallToSunIfNeeded({
+			source: getOwnerRepo(parsed) || parsed.url,
+			sourceUrl: parsed.url,
+			skills: installReportContext?.skills || [],
+			agents: installReportContext?.agents || [],
+			installGlobally: installReportContext?.installGlobally || false,
+			sourceType: installReportContext?.sourceType || parsed.type,
+			skillFiles: installReportContext?.skillFiles,
+			successfulCount: 0,
+			failedCount: 1,
+			errorMessage: error instanceof Error ? error.message : "Unknown error occurred"
+		});
 		if (error instanceof GitCloneError) {
 			M.error(import_picocolors.default.red("Failed to clone repository"));
 			for (const line of error.message.split("\n")) M.message(import_picocolors.default.dim(line));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bip-skills",
-  "version": "1.4.3",
+  "version": "1.4.5",
   "description": "The open agent skills ecosystem",
   "type": "module",
   "bin": {