skilld 0.7.0 → 0.8.2

package/dist/cli.mjs

@@ -5,21 +5,22 @@ import { a as getShippedSkills, b as sanitizeMarkdown, c as linkCachedDir, d as
 import "./cache/index.mjs";
 import { n as clearEmbeddingCache } from "./_chunks/embedding-cache.mjs";
 import { closePool, createIndex, openPool, searchPooled, searchSnippets } from "./retriv/index.mjs";
-import { i as getBlogPreset, n as yamlParseKV, r as yamlUnescape, t as yamlEscape } from "./_chunks/yaml.mjs";
-import { A as resolveEntryFiles, D as fetchGitSkills, I as fetchReleaseNotes, J as generateIssueIndex, K as fetchGitHubIssues, L as generateReleaseIndex, M as formatDiscussionAsMarkdown, N as generateDiscussionIndex, O as parseGitSkillInput, P as fetchBlogReleases, T as isShallowGitDocs, W as parseGitHubUrl, Y as isGhAvailable, d as resolvePackageDocs, f as resolvePackageDocsWithAttempts, g as fetchLlmsTxt, i as fetchPkgDist, j as fetchGitHubDiscussions, m as downloadLlmsDocs, n as fetchNpmPackage, p as searchNpmPackages, q as formatIssueAsMarkdown, r as fetchNpmRegistryMeta, s as readLocalDependencies, t as fetchLatestVersion, u as resolveLocalPackageDocs, v as normalizeLlmsLinks, w as fetchReadmeContent, x as fetchGitDocs, z as $fetch } from "./_chunks/npm.mjs";
+import { a as getSharedSkillsDir, i as SHARED_SKILLS_DIR, n as yamlParseKV, o as mapInsert, r as yamlUnescape, s as getBlogPreset, t as yamlEscape } from "./_chunks/yaml.mjs";
+import { A as resolveEntryFiles, B as $fetch, D as fetchGitSkills, G as parseGitHubUrl, I as fetchReleaseNotes, J as formatIssueAsMarkdown, L as generateReleaseIndex, M as formatDiscussionAsMarkdown, N as generateDiscussionIndex, O as parseGitSkillInput, P as fetchBlogReleases, T as isShallowGitDocs, X as isGhAvailable, Y as generateIssueIndex, d as resolvePackageDocs, f as resolvePackageDocsWithAttempts, g as fetchLlmsTxt, i as fetchPkgDist, j as fetchGitHubDiscussions, m as downloadLlmsDocs, n as fetchNpmPackage, p as searchNpmPackages, q as fetchGitHubIssues, r as fetchNpmRegistryMeta, s as readLocalDependencies, t as fetchLatestVersion, u as resolveLocalPackageDocs, v as normalizeLlmsLinks, w as fetchReadmeContent, x as fetchGitDocs } from "./_chunks/npm.mjs";
 import "./sources/index.mjs";
-import { _ as detectTargetAgent, a as optimizeDocs, d as unlinkSkillFromAgents, g as detectInstalledAgents, i as getModelName, l as linkSkillToAgents, n as getAvailableModels, o as generateSkillMd, r as getModelLabel, s as computeSkillDirName, t as detectImportedPackages, v as getAgentVersion, y as targets } from "./_chunks/detect-imports.mjs";
+import { S as targets, _ as maxItems, a as getModelName, b as detectTargetAgent, c as computeSkillDirName, f as unlinkSkillFromAgents, i as getModelLabel, n as createToolProgress, o as optimizeDocs, r as getAvailableModels, s as generateSkillMd, t as detectImportedPackages, u as linkSkillToAgents, v as maxLines, x as getAgentVersion, y as detectInstalledAgents } from "./_chunks/detect-imports.mjs";
 import "./agent/index.mjs";
 import { n as shutdownWorker } from "./_chunks/pool2.mjs";
 import { createRequire } from "node:module";
 import { homedir } from "node:os";
 import { dirname, join, relative, resolve } from "pathe";
 import { appendFileSync, copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, statSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
-import { execSync, spawn } from "node:child_process";
+import { execSync } from "node:child_process";
 import pLimit from "p-limit";
 import * as p from "@clack/prompts";
 import { defineCommand, runMain } from "citty";
 import { detectCurrentAgent } from "unagent/env";
+import { isCI } from "std-env";
 import logUpdate, { createLogUpdate } from "log-update";
 const defaultFeatures = {
 	search: true,
@@ -450,11 +451,6 @@ function removeLockEntry(skillsDir, skillName) {
 	}
 	writeFileSync(lockPath, serializeLock(lock));
 }
-const SHARED_SKILLS_DIR = ".skills";
-function getSharedSkillsDir(cwd = process.cwd()) {
-	const dir = join(cwd, SHARED_SKILLS_DIR);
-	return existsSync(dir) ? dir : null;
-}
 function* iterateSkills(opts = {}) {
 	const { scope = "all", cwd = process.cwd() } = opts;
 	const agentTypes = opts.agents ?? Object.keys(targets);
@@ -546,7 +542,8 @@ function* iterateSkills(opts = {}) {
 }
 function isOutdated(skill, depVersion) {
 	if (!skill.info?.version) return true;
-	return skill.info.version.split(".").slice(0, 2).join(".") !== depVersion.replace(/^[\^~]/, "").split(".").slice(0, 2).join(".");
+	const depClean = depVersion.replace(/^[\^~]/, "");
+	return skill.info.version !== depClean;
 }
 async function getProjectState(cwd = process.cwd()) {
 	const skills = [...iterateSkills({
@@ -804,61 +801,6 @@ function formatCompactSnippet(r, cols) {
 		preview: firstLine.length > maxPreview ? `${firstLine.slice(0, maxPreview - 1)}…` : firstLine
 	};
 }
-async function syncGitSkills(opts) {
-	const { source, agent, global: isGlobal, yes } = opts;
-	const cwd = process.cwd();
-	const agentConfig = targets[agent];
-	const baseDir = isGlobal ? join(CACHE_DIR, "skills") : join(cwd, agentConfig.skillsDir);
-	const label = source.type === "local" ? source.localPath : `${source.owner}/${source.repo}`;
-	const spin = timedSpinner();
-	spin.start(`Fetching skills from ${label}`);
-	const { skills, commitSha } = await fetchGitSkills(source, (msg) => spin.message(msg));
-	if (skills.length === 0) {
-		spin.stop(`No skills found in ${label}`);
-		return;
-	}
-	spin.stop(`Found ${skills.length} skill(s) in ${label}`);
-	let selected = skills;
-	if (source.skillPath) selected = skills;
-	else if (skills.length > 1 && !yes) {
-		const choices = await p.multiselect({
-			message: `Select skills to install from ${label}`,
-			options: skills.map((s) => ({
-				label: s.name,
-				value: s.name,
-				hint: s.description || s.path
-			})),
-			initialValues: skills.map((s) => s.name)
-		});
-		if (p.isCancel(choices)) return;
-		const selectedNames = new Set(choices);
-		selected = skills.filter((s) => selectedNames.has(s.name));
-	}
-	mkdirSync(baseDir, { recursive: true });
-	for (const skill of selected) {
-		const skillDir = join(baseDir, skill.name);
-		mkdirSync(skillDir, { recursive: true });
-		writeFileSync(join(skillDir, "SKILL.md"), sanitizeMarkdown(skill.content));
-		if (skill.files.length > 0) for (const f of skill.files) {
-			const filePath = join(skillDir, ".skilld", f.path);
-			mkdirSync(dirname(filePath), { recursive: true });
-			writeFileSync(filePath, f.content);
-		}
-		const sourceType = source.type === "local" ? "local" : source.type;
-		writeLock(baseDir, skill.name, {
-			source: sourceType,
-			repo: source.type === "local" ? source.localPath : `${source.owner}/${source.repo}`,
-			path: skill.path || void 0,
-			ref: source.ref || "main",
-			commit: commitSha,
-			syncedAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
-			generator: "external"
-		});
-	}
-	if (!isGlobal) registerProject(cwd);
-	const names = selected.map((s) => `\x1B[36m${s.name}\x1B[0m`).join(", ");
-	p.log.success(`Installed ${names}`);
-}
 const RESOLVE_STEP_LABELS = {
 	"npm": "npm registry",
 	"github-docs": "GitHub docs",
@@ -1308,6 +1250,84 @@ async function indexResources(opts) {
 		}
 	});
 }
+const TELEMETRY_URL = "https://add-skill.vercel.sh/t";
+const SKILLS_VERSION = "1.3.9";
+function isEnabled() {
+	return !process.env.DISABLE_TELEMETRY && !process.env.DO_NOT_TRACK;
+}
+function track(data) {
+	if (!isEnabled()) return;
+	try {
+		const params = new URLSearchParams();
+		params.set("v", SKILLS_VERSION);
+		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(() => {});
+	} catch {}
+}
+async function syncGitSkills(opts) {
+	const { source, agent, global: isGlobal, yes } = opts;
+	const cwd = process.cwd();
+	const agentConfig = targets[agent];
+	const baseDir = isGlobal ? join(CACHE_DIR, "skills") : join(cwd, agentConfig.skillsDir);
+	const label = source.type === "local" ? source.localPath : `${source.owner}/${source.repo}`;
+	const spin = timedSpinner();
+	spin.start(`Fetching skills from ${label}`);
+	const { skills, commitSha } = await fetchGitSkills(source, (msg) => spin.message(msg));
+	if (skills.length === 0) {
+		spin.stop(`No skills found in ${label}`);
+		return;
+	}
+	spin.stop(`Found ${skills.length} skill(s) in ${label}`);
+	let selected = skills;
+	if (source.skillPath) selected = skills;
+	else if (skills.length > 1 && !yes) {
+		const choices = await p.multiselect({
+			message: `Select skills to install from ${label}`,
+			options: skills.map((s) => ({
+				label: s.name,
+				value: s.name,
+				hint: s.description || s.path
+			})),
+			initialValues: skills.map((s) => s.name)
+		});
+		if (p.isCancel(choices)) return;
+		const selectedNames = new Set(choices);
+		selected = skills.filter((s) => selectedNames.has(s.name));
+	}
+	mkdirSync(baseDir, { recursive: true });
+	for (const skill of selected) {
+		const skillDir = join(baseDir, skill.name);
+		mkdirSync(skillDir, { recursive: true });
+		writeFileSync(join(skillDir, "SKILL.md"), sanitizeMarkdown(skill.content));
+		if (skill.files.length > 0) for (const f of skill.files) {
+			const filePath = join(skillDir, ".skilld", f.path);
+			mkdirSync(dirname(filePath), { recursive: true });
+			writeFileSync(filePath, f.content);
+		}
+		const sourceType = source.type === "local" ? "local" : source.type;
+		writeLock(baseDir, skill.name, {
+			source: sourceType,
+			repo: source.type === "local" ? source.localPath : `${source.owner}/${source.repo}`,
+			path: skill.path || void 0,
+			ref: source.ref || "main",
+			commit: commitSha,
+			syncedAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+			generator: "external"
+		});
+	}
+	if (!isGlobal) registerProject(cwd);
+	if (source.type !== "local" && source.owner && source.repo) track({
+		event: "install",
+		source: `${source.owner}/${source.repo}`,
+		skills: selected.map((s) => s.name).join(","),
+		agents: agent,
+		...isGlobal && { global: "1" },
+		sourceType: source.type
+	});
+	const names = selected.map((s) => `\x1B[36m${s.name}\x1B[0m`).join(", ");
+	p.log.success(`Installed ${names}`);
+}
 const STATUS_ICONS = {
 	pending: "○",
 	resolving: "◐",
@@ -1355,7 +1375,7 @@ async function syncPackagesParallel(config) {
 		});
 		const doneCount = [...states.values()].filter((s) => s.status === "done").length;
 		const errorCount = [...states.values()].filter((s) => s.status === "error").length;
-		logUpdate(`\x1B[1mSyncing ${packages.length} packages\x1B[0m (${doneCount} done${errorCount > 0 ? `, ${errorCount} failed` : ""})\n` + lines.join("\n"));
+		logUpdate(`\x1B[1m${config.mode === "update" ? "Updating" : "Syncing"} ${packages.length} packages\x1B[0m (${doneCount} done${errorCount > 0 ? `, ${errorCount} failed` : ""})\n` + lines.join("\n"));
 	}
 	function update(pkg, status, message, version) {
 		const state = states.get(pkg);
@@ -1391,7 +1411,8 @@ async function syncPackagesParallel(config) {
 			});
 		}
 	}
-	const skillMsg = `Created ${successfulPkgs.length} base skills${shippedPkgs.length > 1 ? ` (Skipping ${shippedPkgs.length})` : ""}`;
+	const pastVerb = config.mode === "update" ? "Updated" : "Created";
+	const skillMsg = `${pastVerb} ${successfulPkgs.length} base skills${shippedPkgs.length > 1 ? ` (Skipping ${shippedPkgs.length})` : ""}`;
 	p.log.success(skillMsg);
 	for (const [, data] of skillData) for (const w of data.warnings) p.log.warn(`\x1B[33m${w}\x1B[0m`);
 	if (errors.length > 0) for (const { pkg, reason } of errors) p.log.error(`  ${pkg}: ${reason}`);
@@ -1418,7 +1439,7 @@ async function syncPackagesParallel(config) {
 	await ensureGitignore(getSharedSkillsDir(cwd) ? SHARED_SKILLS_DIR : agent.skillsDir, cwd, config.global);
 	await ensureAgentInstructions(config.agent, cwd, config.global);
 	await shutdownWorker();
-	p.outro(`Synced ${successfulPkgs.length}/${packages.length} packages`);
+	p.outro(`${pastVerb} ${successfulPkgs.length}/${packages.length} packages`);
 }
 async function syncBaseSkill(packageName, config, cwd, update) {
 	const localVersion = (await readLocalDependencies(cwd).catch(() => [])).find((d) => d.name === packageName)?.version;
@@ -1526,7 +1547,7 @@ async function syncBaseSkill(packageName, config, cwd, update) {
 	const shared = !config.global && getSharedSkillsDir(cwd);
 	if (shared) linkSkillToAgents(skillDirName, shared, cwd);
 	if (!config.global) registerProject(cwd);
-	update(packageName, "done", "Base skill created", versionKey);
+	update(packageName, "done", config.mode === "update" ? "Skill updated" : "Base skill created", versionKey);
 	return {
 		resolved,
 		version,
@@ -1601,6 +1622,98 @@ async function enhanceWithLLM(packageName, data, config, cwd, update, sections,
 	}
 	update(packageName, "done", "Skill optimized", versionKey);
 }
+function hasGhCli() {
+	if (process.env.SKILLD_NO_GH) return false;
+	try {
+		execSync("gh --version", { stdio: "ignore" });
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function runWizard() {
+	if (!isInteractive()) return;
+	p.note("Skilld gives your AI agent skill knowledge on your NPM\ndependencies gathered from versioned docs, source code\nand GitHub issues.", "Welcome to skilld");
+	const ghInstalled = hasGhCli();
+	if (ghInstalled) p.log.success("GitHub CLI detected — will use it to pull issues and discussions.");
+	else p.log.warn("GitHub CLI not found. Install it to enable issues/discussions:\n  \x1B[36mhttps://cli.github.com\x1B[0m");
+	const selected = await p.multiselect({
+		message: "Which features would you like to enable?",
+		options: [
+			{
+				label: "Semantic + token search",
+				value: "search",
+				hint: "local query engine to cut token costs and speed up grep"
+			},
+			{
+				label: "Release notes",
+				value: "releases",
+				hint: "track changelogs for installed packages"
+			},
+			{
+				label: "GitHub issues",
+				value: "issues",
+				hint: "surface common problems and solutions",
+				disabled: !ghInstalled
+			},
+			{
+				label: "GitHub discussions",
+				value: "discussions",
+				hint: "include Q&A and community knowledge",
+				disabled: !ghInstalled
+			}
+		],
+		initialValues: [...Object.entries(defaultFeatures).filter(([, v]) => v).map(([k]) => k), ...ghInstalled ? ["issues", "discussions"] : []],
+		required: false
+	});
+	if (p.isCancel(selected)) {
+		p.cancel("Setup cancelled");
+		process.exit(0);
+	}
+	const features = {
+		search: selected.includes("search"),
+		issues: selected.includes("issues"),
+		discussions: selected.includes("discussions"),
+		releases: selected.includes("releases")
+	};
+	const allModels = process.env.SKILLD_NO_AGENTS ? [] : await getAvailableModels();
+	let modelId;
+	if (allModels.length > 0) {
+		p.note("Skills work without an LLM, but one can rewrite your\nSKILL.md files with best practices and better structure.\n\x1B[90mThis is separate from the agent where skills are installed —\nthe target agent is auto-detected from your project files.\x1B[0m", "Optional: LLM optimization");
+		const modelChoice = await p.select({
+			message: "Model for generating SKILL.md",
+			options: [{
+				label: "Skip",
+				value: "",
+				hint: "use raw docs, no LLM needed"
+			}, ...allModels.map((m) => ({
+				label: m.recommended ? `${m.name} (Recommended)` : m.name,
+				value: m.id,
+				hint: `${m.agentName} · ${m.hint}`
+			}))]
+		});
+		if (p.isCancel(modelChoice)) {
+			p.cancel("Setup cancelled");
+			process.exit(0);
+		}
+		modelId = modelChoice || void 0;
+	} else {
+		p.log.warn("No supported LLM CLIs detected (claude, gemini, codex).\n  Skills will still work, but won't be LLM-optimized.");
+		const proceed = await p.confirm({
+			message: "Continue without LLM optimization?",
+			initialValue: true
+		});
+		if (p.isCancel(proceed) || !proceed) {
+			p.cancel("Setup cancelled");
+			process.exit(0);
+		}
+	}
+	updateConfig({
+		features,
+		...modelId ? { model: modelId } : { skipLlm: true }
+	});
+	p.outro("Thanks, you're all set! Change config anytime with `skilld config`.");
+}
 var sync_exports = /* @__PURE__ */ __exportAll({
 	DEFAULT_SECTIONS: () => DEFAULT_SECTIONS,
 	SKILLD_MARKER_END: () => SKILLD_MARKER_END,
@@ -1686,7 +1799,8 @@ async function syncCommand(state, opts) {
 			model: opts.model,
 			yes: opts.yes,
 			force: opts.force,
-			debug: opts.debug
+			debug: opts.debug,
+			mode: opts.mode
 		});
 		await syncSinglePackage(opts.packages[0], opts);
 		return;
@@ -1703,7 +1817,8 @@ async function syncCommand(state, opts) {
 		model: opts.model,
 		yes: opts.yes,
 		force: opts.force,
-		debug: opts.debug
+		debug: opts.debug,
+		mode: opts.mode
 	});
 	await syncSinglePackage(packages[0], opts);
 }
@@ -1790,6 +1905,7 @@ async function selectModel(skipPrompt) {
 }
 const DEFAULT_SECTIONS = ["best-practices", "api-changes"];
 async function selectSkillSections(message = "Generate SKILL.md with LLM") {
+	p.log.info("More sections = less budget each. Fewer sections = deeper coverage.");
 	const selected = await p.multiselect({
 		message,
 		options: [
@@ -1826,6 +1942,25 @@ async function selectSkillSections(message = "Generate SKILL.md with LLM") {
 		sections: [],
 		cancelled: false
 	};
+	if (sections.length > 1) {
+		const n = sections.length;
+		const budgetLines = [];
+		for (const s of sections) switch (s) {
+			case "api-changes":
+				budgetLines.push(`  API changes     ≤${maxLines(50, 80, n)} lines, ${maxItems(6, 12, n)} items`);
+				break;
+			case "best-practices":
+				budgetLines.push(`  Best practices  ≤${maxLines(80, 150, n)} lines, ${maxItems(4, 10, n)} items`);
+				break;
+			case "api":
+				budgetLines.push(`  Doc map         ≤${maxLines(15, 25, n)} lines`);
+				break;
+			case "custom":
+				budgetLines.push(`  Custom          ≤${maxLines(50, 80, n)} lines`);
+				break;
+		}
+		p.log.info(`Budget (${n} sections):\n${budgetLines.join("\n")}`);
+	}
 	let customPrompt;
 	if (sections.includes("custom")) {
 		const heading = await p.text({
@@ -2054,7 +2189,7 @@ async function syncSinglePackage(packageName, config) {
 		features
 	});
 	writeFileSync(join(skillDir, "SKILL.md"), baseSkillMd);
-	p.log.success(`Created base skill: ${relative(cwd, skillDir)}`);
+	p.log.success(config.mode === "update" ? `Updated skill: ${relative(cwd, skillDir)}` : `Created base skill: ${relative(cwd, skillDir)}`);
 	if (!readConfig().skipLlm && (!config.yes || config.model)) {
 		const llmConfig = await selectLlmConfig(config.model);
 		if (llmConfig) {
@@ -2089,7 +2224,7 @@ async function syncSinglePackage(packageName, config) {
 	await ensureGitignore(shared ? SHARED_SKILLS_DIR : targets[config.agent].skillsDir, cwd, config.global);
 	await ensureAgentInstructions(config.agent, cwd, config.global);
 	await shutdownWorker();
-	p.outro(`Synced ${packageName} to ${relative(cwd, skillDir)}`);
+	p.outro(config.mode === "update" ? `Updated ${packageName}` : `Synced ${packageName} to ${relative(cwd, skillDir)}`);
 }
 async function enhanceSkillWithLLM(opts) {
 	const { packageName, version, skillDir, dirName, model, resolved, relatedSkills, hasIssues, hasDiscussions, hasReleases, hasChangelog, docsType, hasShippedDocs: shippedDocs, pkgFiles, force, debug, sections, customPrompt, packages, features } = opts;
@@ -2111,11 +2246,7 @@ async function enhanceSkillWithLLM(opts) {
 		sections,
 		customPrompt,
 		features,
-		onProgress: ({ type, chunk, section }) => {
-			const prefix = section ? `\x1B[90m[${section}]\x1B[0m ` : "";
-			if (type === "reasoning" && chunk.startsWith("[")) llmLog.message(`${prefix}${chunk}`);
-			else if (type === "text") llmLog.message(`${prefix}Writing...`);
-		}
+		onProgress: createToolProgress(llmLog)
 	});
 	if (wasOptimized) {
 		const costParts = [];
@@ -2172,6 +2303,7 @@ const addCommandDef = defineCommand({
 			agent = await promptForAgent();
 			if (!agent) return;
 		}
+		if (!hasCompletedWizard()) await runWizard();
 		const rawInputs = [...new Set([args.package, ...args._ || []].map((s) => s.trim()).filter(Boolean))];
 		const gitSources = [];
 		const npmTokens = [];
@@ -2213,31 +2345,57 @@ const updateCommandDef = defineCommand({
 			description: "Package(s) to update (space or comma-separated). Without args, syncs all outdated.",
 			required: false
 		},
+		background: {
+			type: "boolean",
+			alias: "b",
+			description: "Run in background (detached process, non-interactive)",
+			default: false
+		},
 		...sharedArgs
 	},
 	async run({ args }) {
 		const cwd = process.cwd();
+		if (args.background) {
+			const { spawn } = await import("node:child_process");
+			const updateArgs = [
+				"update",
+				...args.package ? [args.package] : [],
+				...args.agent ? ["--agent", args.agent] : [],
+				...args.model ? ["--model", args.model] : []
+			];
+			spawn(process.execPath, [process.argv[1], ...updateArgs], {
+				cwd,
+				detached: true,
+				stdio: "ignore"
+			}).unref();
+			return;
+		}
+		const silent = !isInteractive();
 		let agent = resolveAgent(args.agent);
 		if (!agent) {
+			if (silent) return;
 			agent = await promptForAgent();
 			if (!agent) return;
 		}
-		const state = await getProjectState(cwd);
-		const generators = getInstalledGenerators();
 		const config = readConfig();
-		p.intro(introLine({
-			state,
-			generators,
-			modelId: config.model
-		}));
+		const state = await getProjectState(cwd);
+		if (!silent) {
+			const generators = getInstalledGenerators();
+			p.intro(introLine({
+				state,
+				generators,
+				modelId: config.model
+			}));
+		}
 		if (args.package) return syncCommand(state, {
 			packages: [...new Set([args.package, ...args._ || []].flatMap((s) => s.split(/[,\s]+/)).map((s) => s.trim()).filter(Boolean))],
 			global: args.global,
 			agent,
-			model: args.model,
-			yes: args.yes,
+			model: args.model || (silent ? config.model : void 0),
+			yes: args.yes || silent,
 			force: args.force,
-			debug: args.debug
+			debug: args.debug,
+			mode: "update"
 		});
 		if (state.outdated.length === 0) {
 			p.log.success("All skills up to date");
@@ -2247,10 +2405,11 @@ const updateCommandDef = defineCommand({
 			packages: state.outdated.map((s) => s.packageName || s.name),
 			global: args.global,
 			agent,
-			model: args.model,
-			yes: args.yes,
+			model: args.model || (silent ? config.model : void 0),
+			yes: args.yes || silent,
 			force: args.force,
-			debug: args.debug
+			debug: args.debug,
+			mode: "update"
 		});
 	}
 });
@@ -2634,11 +2793,7 @@ async function enhanceRegenerated(pkgName, version, skillDir, model, sections, c
 		sections,
 		customPrompt,
 		features,
-		onProgress: ({ type, chunk, section }) => {
-			const prefix = section ? `\x1B[90m[${section}]\x1B[0m ` : "";
-			if (type === "reasoning" && chunk.startsWith("[")) llmLog.message(`${prefix}${chunk}`);
-			else if (type === "text") llmLog.message(`${prefix}Writing...`);
-		}
+		onProgress: createToolProgress(llmLog)
 	});
 	if (wasOptimized) {
 		llmLog.success("Generated best practices");
@@ -3282,13 +3437,11 @@ async function countEmbeddings(packageName, version) {
 	if (!existsSync(dbPath)) return null;
 	try {
 		const { DatabaseSync } = await import("node:sqlite");
-		const db = new DatabaseSync(dbPath, {
+		using db = new DatabaseSync(dbPath, {
 			open: true,
 			readOnly: true
 		});
-		const row = db.prepare("SELECT count(*) as cnt FROM vector_metadata").get();
-		db.close();
-		return row?.cnt ?? null;
+		return db.prepare("SELECT count(*) as cnt FROM vector_metadata").get()?.cnt ?? null;
 	} catch {
 		return null;
 	}
@@ -3363,14 +3516,12 @@ async function statusCommand(opts = {}) {
 	const globalPkgs = /* @__PURE__ */ new Map();
 	for (const skill of allSkills) {
 		const key = skill.info?.packageName || skill.name;
-		const map = skill.scope === "local" ? localPkgs : globalPkgs;
-		if (!map.has(key)) map.set(key, {
+		mapInsert(skill.scope === "local" ? localPkgs : globalPkgs, key, () => ({
 			name: skill.name,
 			info: skill.info || {},
-			agents: new Set([skill.agent]),
+			agents: /* @__PURE__ */ new Set(),
 			scope: skill.scope
-		});
-		else map.get(key).agents.add(skill.agent);
+		})).agents.add(skill.agent);
 	}
 	const buildPackageLines = async (pkgs) => {
 		const lines = [];
@@ -3551,8 +3702,8 @@ async function uninstallCommand(opts) {
 	if (untrackedByDir.size > 0) {
 		const groupedUntracked = /* @__PURE__ */ new Map();
 		for (const [_dir, { label, skills }] of untrackedByDir) {
-			if (!groupedUntracked.has(label)) groupedUntracked.set(label, /* @__PURE__ */ new Set());
-			for (const s of skills) groupedUntracked.get(label).add(s);
+			const set = mapInsert(groupedUntracked, label, () => /* @__PURE__ */ new Set());
+			for (const s of skills) set.add(s);
 		}
 		const totalUntracked = [...groupedUntracked.values()].reduce((sum, s) => sum + s.size, 0);
 		p.log.warn(`${totalUntracked} untracked skill(s) will remain (not managed by skilld):`);
@@ -3565,8 +3716,7 @@ async function uninstallCommand(opts) {
 	const groups = /* @__PURE__ */ new Map();
 	for (const item of toRemove) {
 		const [prefix, name] = item.label.includes(": ") ? item.label.split(": ", 2) : ["other", item.label];
-		if (!groups.has(prefix)) groups.set(prefix, []);
-		groups.get(prefix).push({
+		mapInsert(groups, prefix, () => []).push({
 			name,
 			version: item.version
 		});
@@ -3609,98 +3759,6 @@ const uninstallCommandDef = defineCommand({
 		});
 	}
 });
-function hasGhCli() {
-	if (process.env.SKILLD_NO_GH) return false;
-	try {
-		execSync("gh --version", { stdio: "ignore" });
-		return true;
-	} catch {
-		return false;
-	}
-}
-async function runWizard() {
-	if (!isInteractive()) return;
-	p.note("Skilld gives your AI agent skill knowledge on your NPM\ndependencies gathered from versioned docs, source code\nand GitHub issues.", "Welcome to skilld");
-	const ghInstalled = hasGhCli();
-	if (ghInstalled) p.log.success("GitHub CLI detected — will use it to pull issues and discussions.");
-	else p.log.warn("GitHub CLI not found. Install it to enable issues/discussions:\n  \x1B[36mhttps://cli.github.com\x1B[0m");
-	const selected = await p.multiselect({
-		message: "Which features would you like to enable?",
-		options: [
-			{
-				label: "Semantic + token search",
-				value: "search",
-				hint: "local query engine to cut token costs and speed up grep"
-			},
-			{
-				label: "Release notes",
-				value: "releases",
-				hint: "track changelogs for installed packages"
-			},
-			{
-				label: "GitHub issues",
-				value: "issues",
-				hint: "surface common problems and solutions",
-				disabled: !ghInstalled
-			},
-			{
-				label: "GitHub discussions",
-				value: "discussions",
-				hint: "include Q&A and community knowledge",
-				disabled: !ghInstalled
-			}
-		],
-		initialValues: [...Object.entries(defaultFeatures).filter(([, v]) => v).map(([k]) => k), ...ghInstalled ? ["issues", "discussions"] : []],
-		required: false
-	});
-	if (p.isCancel(selected)) {
-		p.cancel("Setup cancelled");
-		process.exit(0);
-	}
-	const features = {
-		search: selected.includes("search"),
-		issues: selected.includes("issues"),
-		discussions: selected.includes("discussions"),
-		releases: selected.includes("releases")
-	};
-	const allModels = process.env.SKILLD_NO_AGENTS ? [] : await getAvailableModels();
-	let modelId;
-	if (allModels.length > 0) {
-		p.note("Skills work without an LLM, but one can rewrite your\nSKILL.md files with best practices and better structure.\n\x1B[90mThis is separate from the agent where skills are installed —\nthe target agent is auto-detected from your project files.\x1B[0m", "Optional: LLM optimization");
-		const modelChoice = await p.select({
-			message: "Model for generating SKILL.md",
-			options: [{
-				label: "Skip",
-				value: "",
-				hint: "use raw docs, no LLM needed"
-			}, ...allModels.map((m) => ({
-				label: m.recommended ? `${m.name} (Recommended)` : m.name,
-				value: m.id,
-				hint: `${m.agentName} · ${m.hint}`
-			}))]
-		});
-		if (p.isCancel(modelChoice)) {
-			p.cancel("Setup cancelled");
-			process.exit(0);
-		}
-		modelId = modelChoice || void 0;
-	} else {
-		p.log.warn("No supported LLM CLIs detected (claude, gemini, codex).\n  Skills will still work, but won't be LLM-optimized.");
-		const proceed = await p.confirm({
-			message: "Continue without LLM optimization?",
-			initialValue: true
-		});
-		if (p.isCancel(proceed) || !proceed) {
-			p.cancel("Setup cancelled");
-			process.exit(0);
-		}
-	}
-	updateConfig({
-		features,
-		...modelId ? { model: modelId } : { skipLlm: true }
-	});
-	p.outro("Thanks, you're all set! Change config anytime with `skilld config`.");
-}
 const _emit = process.emit;
 process.emit = (event, ...args) => event === "warning" && args[0]?.name === "ExperimentalWarning" && args[0]?.message?.includes("SQLite") ? false : _emit.apply(process, [event, ...args]);
 const NOISE_CHARS = "⣿⡿⣷⣾⣽⣻⢿⡷⣯⣟⡾⣵⣳⢾⡽⣞⡷⣝⢯";
@@ -3790,21 +3848,6 @@ async function brandLoader(work, minMs = 1500) {
 	logUpdate.done();
 	return result;
 }
-async function prepareSync(cwd, agentFlag) {
-	const agent = resolveAgent(agentFlag);
-	if (!agent) return;
-	const state = await getProjectState(cwd);
-	if (state.outdated.length === 0) {
-		p.log.success("Skills up to date");
-		return;
-	}
-	await syncCommand(state, {
-		packages: state.outdated.map((s) => s.packageName || s.name),
-		global: false,
-		agent,
-		yes: true
-	});
-}
 const SUBCOMMAND_NAMES = [
 	"add",
 	"update",
@@ -3823,20 +3866,7 @@ runMain(defineCommand({
 		version,
 		description: "Sync package documentation for agentic use"
 	},
-	args: {
-		prepare: {
-			type: "boolean",
-			description: "Non-interactive sync for pnpm prepare hook (outdated only, no LLM, always exits 0)",
-			default: false
-		},
-		background: {
-			type: "boolean",
-			alias: "b",
-			description: "Run --prepare in background (detached process)",
-			default: false
-		},
-		agent: sharedArgs.agent
-	},
+	args: { agent: sharedArgs.agent },
 	subCommands: {
 		add: () => Promise.resolve().then(() => sync_exports).then((m) => m.addCommandDef),
 		update: () => Promise.resolve().then(() => sync_exports).then((m) => m.updateCommandDef),
@@ -3853,22 +3883,6 @@ runMain(defineCommand({
 		const firstArg = process.argv[2];
 		if (firstArg && !firstArg.startsWith("-") && SUBCOMMAND_NAMES.includes(firstArg)) return;
 		const cwd = process.cwd();
-		if (args.prepare) {
-			if (args.background) {
-				spawn(process.execPath, [
-					process.argv[1],
-					"--prepare",
-					...args.agent ? ["--agent", args.agent] : []
-				], {
-					cwd,
-					detached: true,
-					stdio: "ignore"
-				}).unref();
-				return;
-			}
-			await prepareSync(cwd, args.agent).catch(() => {});
-			return;
-		}
 		if (!isInteractive()) {
 			const state = await getProjectState(cwd);
 			const status = formatStatus(state.synced.length, state.outdated.length);