@tanstack/intent 0.0.36 → 0.0.37

package/dist/cli.mjs

@@ -1,797 +1,51 @@
 #!/usr/bin/env node
-import { s as toPosixPath } from "./utils-COlDcU72.mjs";
-import { n as findWorkspacePackages } from "./workspace-patterns-BN2A_60g.mjs";
-import { i as parseSkillUse } from "./skill-use-BzuuvLM7.mjs";
-import { r as resolveSkillUse } from "./resolver-Whd12ksO.mjs";
-import { t as resolveProjectContext } from "./project-context-alYMNoNa.mjs";
-import { a as scanIntentsOrFail, c as fail, i as resolveStaleTargets, l as isCliFailure, n as runInstallCommand, o as scanOptionsFromGlobalFlags, r as getMetaDir, s as printWarnings } from "./install-2_wkomiT.mjs";
-import { appendFileSync, existsSync, readFileSync, readdirSync, realpathSync } from "node:fs";
-import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { n as isCliFailure, t as fail } from "./cli-error-BrMXlbtx.mjs";
+import { realpathSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { cac } from "cac";
 
-//#region src/commands/edit-package-json.ts
-async function runEditPackageJsonCommand(root) {
-	const { runEditPackageJsonAll } = await import("./setup.mjs");
-	runEditPackageJsonAll(root);
-}
-
-//#endregion
-//#region src/commands/list.ts
-function formatScanCoverage(result) {
-	const coverage = [];
-	if (result.nodeModules.local.scanned) coverage.push("project node_modules");
-	if (result.nodeModules.global.scanned) coverage.push("global node_modules");
-	return coverage.join(", ");
-}
-function printVersionConflicts(result) {
-	if (result.conflicts.length === 0) return;
-	console.log("\nVersion conflicts:\n");
-	for (const conflict of result.conflicts) {
-		console.log(`  ${conflict.packageName} -> using ${conflict.chosen.version}`);
-		console.log(`    chosen: ${conflict.chosen.packageRoot}`);
-		for (const variant of conflict.variants) {
-			if (variant.packageRoot === conflict.chosen.packageRoot) continue;
-			console.log(`    also found: ${variant.version} at ${variant.packageRoot}`);
-		}
-		console.log();
-	}
-}
-async function runListCommand(options, scanIntentsOrFail$1) {
-	const result = await scanIntentsOrFail$1(scanOptionsFromGlobalFlags(options));
-	if (options.json) {
-		console.log(JSON.stringify(result, null, 2));
-		return;
-	}
-	const { computeSkillNameWidth, printSkillTree, printTable } = await import("./display-B3vkG99D.mjs");
-	const scanCoverage = formatScanCoverage(result);
-	if (result.packages.length === 0) {
-		console.log("No intent-enabled packages found.");
-		if (scanCoverage) console.log(`Scanned: ${scanCoverage}`);
-		if (result.warnings.length > 0) {
-			console.log();
-			printWarnings(result.warnings);
-		}
-		return;
-	}
-	const totalSkills = result.packages.reduce((sum, pkg) => sum + pkg.skills.length, 0);
-	console.log(`\n${result.packages.length} intent-enabled packages, ${totalSkills} skills (${result.packageManager})\n`);
-	if (scanCoverage) console.log(`Scanned: ${scanCoverage}${result.nodeModules.global.scanned ? " (local packages take precedence)" : ""}\n`);
-	printTable([
-		"PACKAGE",
-		"SOURCE",
-		"VERSION",
-		"SKILLS",
-		"REQUIRES"
-	], result.packages.map((pkg) => [
-		pkg.name,
-		pkg.source,
-		pkg.version,
-		String(pkg.skills.length),
-		pkg.intent.requires?.join(", ") || "–"
-	]));
-	printVersionConflicts(result);
-	const nameWidth = computeSkillNameWidth(result.packages.map((pkg) => pkg.skills));
-	const showTypes = result.packages.some((pkg) => pkg.skills.some((skill) => skill.type));
-	console.log(`\nSkills:\n`);
-	for (const pkg of result.packages) {
-		console.log(`  ${pkg.name}`);
-		printSkillTree(pkg.skills, {
-			nameWidth,
-			packageName: pkg.name,
-			showTypes
-		});
-		console.log();
-	}
-	console.log("Feedback:");
-	console.log("  Submit feedback on skill usage to help maintainers improve the skills.");
-	console.log("  Load: node_modules/@tanstack/intent/meta/feedback-collection/SKILL.md");
-	console.log();
-	printWarnings(result.warnings);
-}
-
-//#endregion
-//#region src/commands/load.ts
-function resolveFromCwd(path) {
-	return resolve(process.cwd(), path);
-}
-function isPathInsidePackageRoot(path, packageRoot) {
-	const relativePath = relative(resolveFromCwd(packageRoot), resolveFromCwd(path));
-	return relativePath === "" || !relativePath.startsWith("..") && !isAbsolute(relativePath);
-}
-function splitDestinationSuffix(destination) {
-	const hashIndex = destination.indexOf("#");
-	const queryIndex = destination.indexOf("?");
-	const suffixIndex = hashIndex === -1 ? queryIndex : queryIndex === -1 ? hashIndex : Math.min(hashIndex, queryIndex);
-	if (suffixIndex === -1) return {
-		pathPart: destination,
-		suffix: ""
-	};
-	return {
-		pathPart: destination.slice(0, suffixIndex),
-		suffix: destination.slice(suffixIndex)
-	};
-}
-function isExternalOrAbsoluteDestination(destination) {
-	return destination === "" || destination.startsWith("#") || destination.startsWith("?") || destination.startsWith("//") || /^[A-Za-z][A-Za-z0-9+.-]*:/.test(destination) || isAbsolute(destination);
-}
-function findClosingBracket(line, start) {
-	let depth = 0;
-	for (let index = start; index < line.length; index++) {
-		const char = line[index];
-		if (char === "\\") {
-			index++;
-			continue;
-		}
-		if (char === "[") {
-			depth++;
-			continue;
-		}
-		if (char === "]") {
-			depth--;
-			if (depth === 0) return index;
-		}
-	}
-	return -1;
-}
-function findClosingParen(line, start) {
-	for (let index = start; index < line.length; index++) {
-		const char = line[index];
-		if (char === "\\") {
-			index++;
-			continue;
-		}
-		if (char === ")") return index;
-	}
-	return -1;
-}
-function readBareDestination(line, start) {
-	let depth = 0;
-	for (let index = start; index < line.length; index++) {
-		const char = line[index];
-		if (char === "\\") {
-			index++;
-			continue;
-		}
-		if (char === "(") {
-			depth++;
-			continue;
-		}
-		if (char === ")") {
-			if (depth === 0) return {
-				destinationEnd: index,
-				endParen: index
-			};
-			depth--;
-			continue;
-		}
-		if (/\s/.test(char) && depth === 0) {
-			const endParen = findClosingParen(line, index);
-			if (endParen === -1) return null;
-			return {
-				destinationEnd: index,
-				endParen
-			};
-		}
-	}
-	return null;
-}
-function readMarkdownDestination(line, start) {
-	let cursor = start;
-	while (cursor < line.length && /\s/.test(line[cursor])) cursor++;
-	if (line[cursor] === "<") {
-		const destinationStart = cursor + 1;
-		const destinationEnd = line.indexOf(">", destinationStart);
-		if (destinationEnd === -1) return null;
-		const endParen = findClosingParen(line, destinationEnd + 1);
-		if (endParen === -1) return null;
-		return {
-			destination: line.slice(destinationStart, destinationEnd),
-			destinationStart,
-			destinationEnd,
-			endParen
-		};
-	}
-	const read = readBareDestination(line, cursor);
-	if (!read) return null;
-	return {
-		destination: line.slice(cursor, read.destinationEnd),
-		destinationStart: cursor,
-		destinationEnd: read.destinationEnd,
-		endParen: read.endParen
-	};
-}
-function getCodeFenceMarker(line) {
-	const marker = line.match(/^\s*(`{3,}|~{3,})/)?.[1]?.[0];
-	return marker === "`" || marker === "~" ? marker : null;
-}
-function rewriteMarkdownDestination({ context, destination }) {
-	if (isExternalOrAbsoluteDestination(destination)) return destination;
-	const { pathPart, suffix } = splitDestinationSuffix(destination);
-	if (isExternalOrAbsoluteDestination(pathPart)) return destination;
-	const resolvedDestinationPath = resolve(context.skillDir, pathPart);
-	const relativeToPackageRoot = relative(context.resolvedPackageRoot, resolvedDestinationPath);
-	if (relativeToPackageRoot.startsWith("..") || isAbsolute(relativeToPackageRoot)) return destination;
-	const relativeToCwd = relative(context.cwd, resolvedDestinationPath);
-	return `${toPosixPath(relativeToCwd && !relativeToCwd.startsWith("..") && !isAbsolute(relativeToCwd) ? relativeToCwd : resolvedDestinationPath)}${suffix}`;
-}
-function rewriteMarkdownLineDestinations({ context, line }) {
-	if (!line.includes("[")) return line;
-	let output = "";
-	let cursor = 0;
-	while (cursor < line.length) {
-		const nextCodeStart = line.indexOf("`", cursor);
-		const nextLinkStart = line.indexOf("[", cursor);
-		if (nextLinkStart === -1) {
-			output += line.slice(cursor);
-			break;
-		}
-		if (nextCodeStart !== -1 && nextCodeStart < nextLinkStart) {
-			output += line.slice(cursor, nextCodeStart);
-			cursor = nextCodeStart;
-			const codeStart = cursor;
-			while (cursor < line.length && line[cursor] === "`") cursor++;
-			const marker = line.slice(codeStart, cursor);
-			const codeEnd = line.indexOf(marker, cursor);
-			if (codeEnd === -1) {
-				output += line.slice(codeStart);
-				break;
-			}
-			output += line.slice(codeStart, codeEnd + marker.length);
-			cursor = codeEnd + marker.length;
-			continue;
-		}
-		const linkStart = nextLinkStart > 0 && line[nextLinkStart - 1] === "!" ? nextLinkStart - 1 : nextLinkStart;
-		output += line.slice(cursor, linkStart);
-		const labelEnd = findClosingBracket(line, nextLinkStart);
-		if (labelEnd === -1) {
-			output += line.slice(linkStart);
-			break;
-		}
-		if (line[labelEnd + 1] !== "(") {
-			output += line.slice(linkStart, nextLinkStart + 1);
-			cursor = nextLinkStart + 1;
-			continue;
-		}
-		const destination = readMarkdownDestination(line, labelEnd + 2);
-		if (!destination) {
-			output += line.slice(linkStart, nextLinkStart + 1);
-			cursor = nextLinkStart + 1;
-			continue;
-		}
-		const rewritten = rewriteMarkdownDestination({
-			context,
-			destination: destination.destination
-		});
-		output += line.slice(linkStart, destination.destinationStart) + rewritten + line.slice(destination.destinationEnd, destination.endParen + 1);
-		cursor = destination.endParen + 1;
-	}
-	return output;
-}
-function rewriteLoadedSkillMarkdownDestinations({ content, packageRoot, skillFilePath }) {
-	const context = {
-		cwd: process.cwd(),
-		resolvedPackageRoot: resolveFromCwd(packageRoot),
-		skillDir: dirname(skillFilePath)
-	};
-	let inFence = null;
-	const parts = content.split(/(\r?\n)/);
-	let output = "";
-	for (let index = 0; index < parts.length; index += 2) {
-		const line = parts[index] ?? "";
-		const newline = parts[index + 1] ?? "";
-		const marker = getCodeFenceMarker(line);
-		if (inFence) {
-			output += line + newline;
-			if (marker === inFence) inFence = null;
-			continue;
-		}
-		if (marker) {
-			inFence = marker;
-			output += line + newline;
-			continue;
-		}
-		output += rewriteMarkdownLineDestinations({
-			context,
-			line
-		}) + newline;
-	}
-	return output;
-}
-async function runLoadCommand(use, options, scanIntentsOrFail$1) {
-	if (!use) fail("Missing skill use. Expected: intent load <package>#<skill>");
-	if (options.json && options.path) fail("Use either --json or --path, not both.");
-	parseSkillUse(use);
-	const resolved = resolveSkillUse(use, await scanIntentsOrFail$1(scanOptionsFromGlobalFlags(options)));
-	const resolvedPath = resolveFromCwd(resolved.path);
-	if (!isPathInsidePackageRoot(resolved.path, resolved.packageRoot)) fail(`Resolved skill path for "${use}" is outside package root: ${resolved.path}`);
-	if (!existsSync(resolvedPath)) fail(`Resolved skill file was not found: ${resolved.path}`);
-	if (options.path) {
-		console.log(resolved.path);
-		for (const warning of resolved.warnings) console.error(`Warning: ${warning}`);
-		return;
-	}
-	const content = rewriteLoadedSkillMarkdownDestinations({
-		content: readFileSync(resolvedPath, "utf8"),
-		packageRoot: resolved.packageRoot,
-		skillFilePath: resolvedPath
-	});
-	if (options.json) {
-		console.log(JSON.stringify({
-			package: resolved.packageName,
-			skill: resolved.skillName,
-			path: resolved.path,
-			packageRoot: resolved.packageRoot,
-			source: resolved.source,
-			version: resolved.version,
-			content,
-			warnings: resolved.warnings
-		}, null, 2));
-		return;
-	}
-	process.stdout.write(content);
-	for (const warning of resolved.warnings) console.error(`Warning: ${warning}`);
-}
-
-//#endregion
-//#region src/commands/meta.ts
-async function runMetaCommand(name, metaDir) {
-	if (!existsSync(metaDir)) fail("Meta-skills directory not found.");
-	if (name) {
-		if (name.includes("..") || name.includes("/") || name.includes("\\")) fail(`Invalid meta-skill name: "${name}"`);
-		const skillFile = join(metaDir, name, "SKILL.md");
-		if (!existsSync(skillFile)) fail(`Meta-skill "${name}" not found. Run \`intent meta\` to list available meta-skills.`);
-		try {
-			console.log(readFileSync(skillFile, "utf8"));
-		} catch (err) {
-			fail(`Failed to read meta-skill "${name}": ${err instanceof Error ? err.message : String(err)}`);
-		}
-		return;
-	}
-	const { parseFrontmatter } = await import("./utils-dkVvY7D7.mjs");
-	const entries = readdirSync(metaDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).filter((entry) => existsSync(join(metaDir, entry.name, "SKILL.md")));
-	if (entries.length === 0) {
-		console.log("No meta-skills found.");
-		return;
-	}
-	console.log("Meta-skills (for library maintainers):\n");
-	for (const entry of entries) {
-		const fm = parseFrontmatter(join(metaDir, entry.name, "SKILL.md"));
-		let description = "";
-		if (typeof fm?.description === "string") description = fm.description.replace(/\s+/g, " ").trim();
-		const shortDesc = description.length > 60 ? `${description.slice(0, 57)}...` : description;
-		console.log(`  ${entry.name.padEnd(28)} ${shortDesc}`);
-	}
-	console.log("\nUsage: load the SKILL.md into your AI agent conversation.");
-	console.log("Path: node_modules/@tanstack/intent/meta/<name>/SKILL.md");
-}
-
-//#endregion
-//#region src/commands/scaffold.ts
-function runScaffoldCommand(metaDir) {
-	function metaSkillPath(name) {
-		return join(metaDir, name, "SKILL.md");
-	}
-	const prompt = `You are helping a library maintainer scaffold Intent skills.
-
-Run the three meta skills below **one at a time, in order**. For each step:
-1. Load the SKILL.md file specified
-2. Follow its instructions completely
-3. Present outputs to the maintainer for review
-4. Do NOT proceed to the next step until the maintainer confirms
-
-## Before you start
-
-Gather this context yourself (do not ask the maintainer — agents should never
-ask for information they can discover):
-1. Read package.json for library name, repository URL, and homepage/docs URL
-2. Detect if this is a monorepo (look for workspaces field, packages/ directory, lerna.json)
-3. Use skills/ as the default skills root
-4. For monorepos:
-   - Domain map artifacts go at the REPO ROOT: _artifacts/
-   - Skills go INSIDE EACH PACKAGE: packages/<pkg>/skills/
-   - Identify which packages are client-facing (usually client SDKs and primary framework adapters)
-
----
-
-## Step 1 — Domain Discovery
-
-Load and follow: ${metaSkillPath("domain-discovery")}
-
-This produces: domain_map.yaml and skill_spec.md in the artifacts directory.
-Domain discovery covers the WHOLE library (one domain map even for monorepos).
-
-**STOP. Review outputs with the maintainer before continuing.**
-
----
-
-## Step 2 — Tree Generator
-
-Load and follow: ${metaSkillPath("tree-generator")}
-
-This produces: skill_tree.yaml in the artifacts directory.
-For monorepos, each skill entry should include a \`package\` field.
-
-**STOP. Review outputs with the maintainer before continuing.**
-
----
-
-## Step 3 — Generate Skills
-
-Load and follow: ${metaSkillPath("generate-skill")}
-
-This produces: individual SKILL.md files.
-- Single-repo: skills/<domain>/<skill>/SKILL.md
-- Monorepo: packages/<pkg>/skills/<domain>/<skill>/SKILL.md
-
----
-
-## After all skills are generated
-
-1. Run \`intent validate\` in each package directory
-2. Commit skills/ and artifacts
-3. For each publishable package, run: \`npx @tanstack/intent edit-package-json\`
-4. Ensure each package has \`@tanstack/intent\` as a devDependency
-5. Create a \`skill:<skill-name>\` label on the GitHub repo for each skill (use \`gh label create\`)
-6. Add a README note: "If you use an AI agent, run \`npx @tanstack/intent@latest install\`"
-`;
-	console.log(prompt);
-}
-
-//#endregion
-//#region src/commands/setup-github-actions.ts
-async function runSetupGithubActionsCommand(root, metaDir) {
-	const { runSetupGithubActions } = await import("./setup.mjs");
-	runSetupGithubActions(root, metaDir);
-}
-
-//#endregion
-//#region src/commands/stale.ts
-async function runStaleCommand(targetDir, options, resolveStaleTargets$1) {
-	if (options.githubReview) {
-		await runGithubReview(targetDir, options, resolveStaleTargets$1);
-		return;
-	}
-	const { reports, workflowAdvisories = [] } = await resolveStaleTargets$1(targetDir);
-	if (options.json) {
-		console.log(JSON.stringify(reports, null, 2));
-		return;
-	}
-	for (const advisory of workflowAdvisories) console.log(advisory);
-	if (workflowAdvisories.length > 0) console.log();
-	if (reports.length === 0) {
-		console.log("No intent-enabled packages found.");
-		return;
-	}
-	for (const report of reports) {
-		const driftLabel = report.versionDrift ? ` [${report.versionDrift} drift]` : "";
-		const vLabel = report.skillVersion && report.currentVersion ? ` (${report.skillVersion} → ${report.currentVersion})` : "";
-		console.log(`${report.library}${vLabel}${driftLabel}`);
-		const stale = report.skills.filter((skill) => skill.needsReview);
-		const signals = report.signals.filter((signal) => signal.needsReview);
-		if (stale.length === 0 && signals.length === 0) console.log("  All skills up-to-date");
-		else {
-			for (const skill of stale) console.log(`  ⚠ ${skill.name}: ${skill.reasons.join(", ")}`);
-			for (const signal of signals) {
-				const subject = signal.packageName ?? signal.packageRoot ?? signal.skill ?? signal.artifactPath ?? signal.subject ?? report.library;
-				console.log(`  ⚠ ${subject}: ${signal.reasons.join(", ")}`);
-			}
-		}
-		console.log();
-	}
-}
-async function runGithubReview(targetDir, options, resolveStaleTargets$1) {
-	const { collectStaleReviewItems, createFailedStaleReviewItem, createWorkflowAdvisoryReviewItems, writeStaleReviewWorkflowFiles } = await import("./workflow-review-Dz_ofcYQ.mjs");
-	const packageLabel = options.packageLabel ?? "workspace";
-	try {
-		const { reports, workflowAdvisories = [] } = await resolveStaleTargets$1(targetDir);
-		const items = [...collectStaleReviewItems(reports), ...createWorkflowAdvisoryReviewItems(packageLabel, workflowAdvisories)];
-		writeStaleReviewWorkflowFiles(items);
-		if (items.length === 0) console.log("No stale skills or coverage gaps found.");
-		else console.log(`Wrote ${items.length} intent skill review item(s).`);
-	} catch (err) {
-		writeStaleReviewWorkflowFiles([createFailedStaleReviewItem(packageLabel)]);
-		const message = err instanceof Error ? err.message : String(err);
-		console.log(`Intent stale check failed: ${message}`);
-		console.log("Wrote a review PR body so maintainers can inspect the logs.");
-	}
-}
-
-//#endregion
-//#region src/commands/validate.ts
-const agentSkillNamePattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-function buildValidationFailure(errors, warnings) {
-	const lines = [
-		"",
-		`❌ Validation failed with ${errors.length} error(s):`,
-		""
-	];
-	for (const { file, message } of errors) lines.push(`  ${file}: ${message}`);
-	if (warnings.length > 0) {
-		lines.push("", "⚠ Packaging warnings:");
-		for (const warning of warnings) lines.push(`  ${warning}`);
-	}
-	return lines.join("\n");
-}
-function collectPackagingWarnings(context) {
-	if (!context.packageRoot || !context.targetPackageJsonPath) return [];
-	const pkgJsonPath = context.targetPackageJsonPath;
-	if (!existsSync(pkgJsonPath)) return [];
-	let pkgJson;
-	try {
-		pkgJson = JSON.parse(readFileSync(pkgJsonPath, "utf8"));
-	} catch (err) {
-		return [`Could not parse package.json: ${err instanceof Error ? err.message : String(err)}`];
-	}
-	const warnings = [];
-	if (!pkgJson.devDependencies?.["@tanstack/intent"]) warnings.push("@tanstack/intent is not in devDependencies");
-	const keywords = pkgJson.keywords;
-	if (!Array.isArray(keywords) || !keywords.includes("tanstack-intent")) warnings.push("Missing \"tanstack-intent\" in keywords array");
-	const files = pkgJson.files;
-	if (Array.isArray(files)) {
-		if (!files.includes("skills")) warnings.push("\"skills\" is not in the \"files\" array — skills won't be published");
-		if (!context.isMonorepo && !files.includes("!skills/_artifacts")) warnings.push("\"!skills/_artifacts\" is not in the \"files\" array — artifacts will be published unnecessarily");
-	}
-	return warnings;
-}
-function formatWarning({ file, message }) {
-	return `${file}: ${message}`;
-}
-function isRecord(value) {
-	return !!value && typeof value === "object" && !Array.isArray(value);
-}
-function collectAgentSkillSpecWarnings({ filePath, fm, rel }) {
-	const warnings = [];
-	if (typeof fm.name === "string") {
-		if (fm.name.length > 64) warnings.push({
-			file: rel,
-			message: `Agent Skills spec warning: name exceeds 64 characters (${fm.name.length} chars)`
-		});
-		for (const segment of fm.name.split("/")) if (!agentSkillNamePattern.test(segment)) {
-			warnings.push({
-				file: rel,
-				message: "Agent Skills spec warning: each name segment should use lowercase letters, numbers, and single hyphens only"
-			});
-			break;
-		}
-		const parentDir = basename(dirname(filePath));
-		if (!fm.name.includes("/") && fm.name !== parentDir) warnings.push({
-			file: rel,
-			message: "Agent Skills spec warning: name should match the parent directory name"
-		});
-	}
-	if (fm.license !== void 0 && (typeof fm.license !== "string" || fm.license.trim().length === 0)) warnings.push({
-		file: rel,
-		message: "Agent Skills spec warning: license should be a non-empty string"
-	});
-	if (fm.compatibility !== void 0) {
-		if (typeof fm.compatibility !== "string" || fm.compatibility.trim().length === 0) warnings.push({
-			file: rel,
-			message: "Agent Skills spec warning: compatibility should be a non-empty string"
-		});
-		else if (fm.compatibility.length > 500) warnings.push({
-			file: rel,
-			message: `Agent Skills spec warning: compatibility exceeds 500 characters (${fm.compatibility.length} chars)`
-		});
-	}
-	if (fm.metadata !== void 0) {
-		if (!isRecord(fm.metadata)) warnings.push({
-			file: rel,
-			message: "Agent Skills spec warning: metadata should be a mapping"
-		});
-		else if (Object.values(fm.metadata).some((value) => typeof value !== "string")) warnings.push({
-			file: rel,
-			message: "Agent Skills spec warning: metadata values should be strings"
-		});
-	}
-	if (fm["allowed-tools"] !== void 0 && typeof fm["allowed-tools"] !== "string") warnings.push({
-		file: rel,
-		message: "Agent Skills spec warning: allowed-tools should be a space-separated string"
-	});
-	return warnings;
-}
-async function runValidateCommand(dir, options = {}) {
-	if (!options.githubSummary) {
-		await runValidateCommandInternal(dir);
-		return;
-	}
-	try {
-		await runValidateCommandInternal(dir);
-		writeGithubValidationSummary({ ok: true });
-	} catch (err) {
-		writeGithubValidationSummary({
-			ok: false,
-			message: validationErrorMessage(err)
-		});
-		throw err;
-	}
-}
-async function runValidateCommandInternal(dir) {
-	const [{ parse: parseYaml }, { findSkillFiles }] = await Promise.all([import("yaml"), import("./utils-dkVvY7D7.mjs")]);
-	const context = resolveProjectContext({
-		cwd: process.cwd(),
-		targetPath: dir
-	});
-	const explicitDir = dir !== void 0;
-	const skillsDirs = explicitDir ? [context.targetSkillsDir ?? resolve(process.cwd(), dir)] : collectDefaultSkillsDirs(context, findSkillFiles);
-	if (explicitDir && !existsSync(skillsDirs[0])) fail(`Skills directory not found: ${skillsDirs[0]}`);
-	const errors = [];
-	const warnings = [];
-	let validatedCount = 0;
-	if (explicitDir && findSkillFiles(skillsDirs[0]).length === 0) fail("No SKILL.md files found");
-	if (skillsDirs.length === 0) {
-		console.log("No skills/ directory found — skipping validation.");
-		return;
-	}
-	for (const skillsDir of skillsDirs) {
-		const skillFiles = findSkillFiles(skillsDir);
-		const validateContext = resolveProjectContext({
-			cwd: process.cwd(),
-			targetPath: skillsDir
-		});
-		for (const filePath of skillFiles) {
-			const rel = relative(process.cwd(), filePath);
-			const content = readFileSync(filePath, "utf8");
-			const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)/);
-			if (!match) {
-				errors.push({
-					file: rel,
-					message: "Missing or invalid frontmatter"
-				});
-				continue;
-			}
-			if (!match[1]) {
-				errors.push({
-					file: rel,
-					message: "Missing YAML frontmatter"
-				});
-				continue;
-			}
-			let fm;
-			try {
-				fm = parseYaml(match[1]);
-			} catch (err) {
-				const detail = err instanceof Error ? err.message : String(err);
-				errors.push({
-					file: rel,
-					message: `Invalid YAML frontmatter: ${detail}`
-				});
-				continue;
-			}
-			if (!fm.name) errors.push({
-				file: rel,
-				message: "Missing required field: name"
-			});
-			if (!fm.description) errors.push({
-				file: rel,
-				message: "Missing required field: description"
-			});
-			if (typeof fm.name === "string") {
-				const expectedPath = relative(skillsDir, filePath).replace(/[/\\]SKILL\.md$/, "").split(sep).join("/");
-				if (fm.name !== expectedPath) errors.push({
-					file: rel,
-					message: `name "${fm.name}" does not match directory path "${expectedPath}"`
-				});
-			}
-			if (typeof fm.description === "string" && fm.description.length > 1024) errors.push({
-				file: rel,
-				message: `Description exceeds 1024 character limit (${fm.description.length} chars)`
-			});
-			if (fm.type === "framework" && !Array.isArray(fm.requires)) errors.push({
-				file: rel,
-				message: "Framework skills must have a \"requires\" field"
-			});
-			warnings.push(...collectAgentSkillSpecWarnings({
-				filePath,
-				fm,
-				rel
-			}).map(formatWarning));
-			const lineCount = content.split(/\r?\n/).length;
-			if (lineCount > 500) errors.push({
-				file: rel,
-				message: `Exceeds 500 line limit (${lineCount} lines). Rewrite for conciseness: move API tables to references/, trim verbose examples, and remove content an agent already knows. Do not simply raise the limit.`
-			});
-		}
-		const artifactsDir = join(skillsDir, "_artifacts");
-		if (!validateContext.isMonorepo && existsSync(artifactsDir)) for (const fileName of [
-			"domain_map.yaml",
-			"skill_spec.md",
-			"skill_tree.yaml"
-		]) {
-			const artifactPath = join(artifactsDir, fileName);
-			if (!existsSync(artifactPath)) {
-				errors.push({
-					file: relative(process.cwd(), artifactPath),
-					message: "Missing required artifact"
-				});
-				continue;
-			}
-			const content = readFileSync(artifactPath, "utf8");
-			if (content.trim().length === 0) {
-				errors.push({
-					file: relative(process.cwd(), artifactPath),
-					message: "Artifact file is empty"
-				});
-				continue;
-			}
-			if (fileName.endsWith(".yaml")) try {
-				parseYaml(content);
-			} catch (err) {
-				const detail = err instanceof Error ? err.message : String(err);
-				errors.push({
-					file: relative(process.cwd(), artifactPath),
-					message: `Invalid YAML in artifact file: ${detail}`
-				});
-			}
-		}
-		validatedCount += skillFiles.length;
-		warnings.push(...collectPackagingWarnings(validateContext));
-	}
-	if (errors.length > 0) fail(buildValidationFailure(errors, warnings));
-	console.log(`✅ Validated ${validatedCount} skill files — all passed`);
-	if (warnings.length > 0) console.log();
-	printWarnings(warnings);
-}
-function validationErrorMessage(err) {
-	if (isCliFailure(err)) return err.message;
-	if (err instanceof Error) return err.message;
-	return String(err);
-}
-function writeGithubValidationSummary({ message, ok }) {
-	const summaryPath = process.env.GITHUB_STEP_SUMMARY;
-	if (!summaryPath) return;
-	const lines = ["### Intent skill validation", ""];
-	if (ok) lines.push("Skill validation passed.", "");
-	else lines.push("Skill validation failed.", "", "Why this failed:", "", "Intent validates SKILL.md frontmatter, skill names, required fields, size limits, framework requirements, and artifact files.", "The command output below contains the exact file-level reasons to fix.", "", "Run locally:", "", "```bash", "npx @tanstack/intent@latest validate", "```", "", "Command output:", "", "```text", message ?? "Unknown validation error.", "```", "");
-	appendFileSync(summaryPath, lines.join("\n"));
-}
-function collectDefaultSkillsDirs(context, findSkillFiles) {
-	const skillsDirs = [];
-	const addSkillsDir = (skillsDir) => {
-		if (existsSync(skillsDir) && findSkillFiles(skillsDir).length > 0) skillsDirs.push(skillsDir);
-	};
-	if (context.workspaceRoot && context.cwd === context.workspaceRoot) {
-		addSkillsDir(join(context.workspaceRoot, "skills"));
-		for (const packageDir of findWorkspacePackages(context.workspaceRoot)) addSkillsDir(join(packageDir, "skills"));
-		return [...new Set(skillsDirs)].sort((a, b) => a.localeCompare(b));
-	}
-	addSkillsDir(context.targetSkillsDir ?? (context.packageRoot ? join(context.packageRoot, "skills") : resolve(context.cwd, "skills")));
-	return skillsDirs;
-}
-
-//#endregion
 //#region src/cli.ts
 function createCli() {
 	const cli = cac("intent");
 	cli.usage("<command> [options]");
-	cli.command("list", "Discover intent-enabled packages from the project or workspace").usage("list [--json] [--global] [--global-only]").option("--json", "Output JSON").option("--global", "Include global packages after project packages").option("--global-only", "List global packages only").example("list").example("list --json").example("list --global").action(async (options) => {
-		await runListCommand(options, scanIntentsOrFail);
+	cli.command("list", "Discover intent-enabled packages from the project or workspace").usage("list [--json] [--debug] [--exclude <pattern>] [--global] [--global-only]").option("--json", "Output JSON").option("--debug", "Print discovery debug details to stderr").option("--exclude <pattern>", "Exclude package name glob").option("--global", "Include global packages after project packages").option("--global-only", "List global packages only").example("list").example("list --json").example("list --global").action(async (options) => {
+		const { runListCommand } = await import("./list-D6osUZl7.mjs");
+		await runListCommand(options);
 	});
-	cli.command("load [use]", "Load a compact skill use and print its SKILL.md").usage("load <use> [--path] [--json] [--global] [--global-only]").option("--path", "Print the resolved skill path instead of file content").option("--json", "Output JSON").option("--global", "Load from project packages, then global packages").option("--global-only", "Load from global packages only").example("load @tanstack/query#core").example("load @tanstack/query#core --path").action(async (use, options) => {
-		await runLoadCommand(use, options, scanIntentsOrFail);
+	cli.command("load [use]", "Load a compact skill use and print its SKILL.md").usage("load <use> [--path] [--json] [--debug] [--exclude <pattern>] [--global] [--global-only]").option("--path", "Print the resolved skill path instead of file content").option("--json", "Output JSON").option("--debug", "Print resolution debug details to stderr").option("--exclude <pattern>", "Exclude package name glob").option("--global", "Load from project packages, then global packages").option("--global-only", "Load from global packages only").example("load @tanstack/query#core").example("load @tanstack/query#core --path").action(async (use, options) => {
+		const { runLoadCommand } = await import("./load-CzvLUFur.mjs");
+		await runLoadCommand(use, options);
 	});
 	cli.command("meta [name]", "List meta-skills, or print one by name").usage("meta [name]").example("meta").example("meta domain-discovery").action(async (name) => {
+		const [{ getMetaDir }, { runMetaCommand }] = await Promise.all([import("./cli-support-CHEYZ9xj.mjs"), import("./meta-CYV9EzM8.mjs")]);
 		await runMetaCommand(name, getMetaDir());
 	});
 	cli.command("validate [dir]", "Validate skill files").usage("validate [dir] [--github-summary]").option("--github-summary", "Write a GitHub Actions step summary").example("validate").example("validate packages/query/skills").action(async (dir, options) => {
+		const { runValidateCommand } = await import("./validate-ugk2DZBd.mjs");
 		await runValidateCommand(dir, options);
 	});
 	cli.command("install", "Create or update skill loading guidance in an agent config file").usage("install [--map] [--dry-run] [--print-prompt] [--global] [--global-only]").option("--map", "Write explicit skill-to-task mappings").option("--dry-run", "Print the generated block without writing").option("--print-prompt", "Print the legacy agent setup prompt instead of writing").option("--global", "Include global packages after project packages").option("--global-only", "Install mappings from global packages only").example("install").example("install --map").example("install --dry-run").example("install --print-prompt").example("install --global").action(async (options) => {
+		const [{ scanIntentsOrFail }, { runInstallCommand }] = await Promise.all([import("./cli-support-CHEYZ9xj.mjs"), import("./install-BAUG1FD8.mjs")]);
 		await runInstallCommand(options, scanIntentsOrFail);
 	});
-	cli.command("scaffold", "Print maintainer scaffold prompt").usage("scaffold").action(() => {
+	cli.command("scaffold", "Print maintainer scaffold prompt").usage("scaffold").action(async () => {
+		const [{ getMetaDir }, { runScaffoldCommand }] = await Promise.all([import("./cli-support-CHEYZ9xj.mjs"), import("./scaffold-D2vwv9ls.mjs")]);
 		runScaffoldCommand(getMetaDir());
 	});
 	cli.command("stale [dir]", "Check skills for staleness in the current package or workspace").usage("stale [dir] [--json] [--github-review]").option("--json", "Output JSON").option("--github-review", "Write GitHub Actions review PR files").option("--package-label <label>", "Fallback package label for review PRs").example("stale").example("stale packages/query").example("stale --json").action(async (targetDir, options) => {
+		const [{ resolveStaleTargets }, { runStaleCommand }] = await Promise.all([import("./cli-support-CHEYZ9xj.mjs"), import("./stale-flPZnWfI.mjs")]);
 		await runStaleCommand(targetDir, options, resolveStaleTargets);
 	});
 	cli.command("edit-package-json", "Update package.json files so skills are published").usage("edit-package-json").action(async () => {
+		const { runEditPackageJsonCommand } = await import("./edit-package-json-CzWlMXOf.mjs");
 		await runEditPackageJsonCommand(process.cwd());
 	});
 	cli.command("setup", "Copy Intent CI workflow templates into .github/workflows/").usage("setup").action(async () => {
+		const [{ getMetaDir }, { runSetupGithubActionsCommand }] = await Promise.all([import("./cli-support-CHEYZ9xj.mjs"), import("./setup-github-actions-emXSyGy3.mjs")]);
 		await runSetupGithubActionsCommand(process.cwd(), getMetaDir());
 	});
 	cli.command("setup-github-actions", "Copy Intent CI workflow templates into .github/workflows/").usage("setup-github-actions").action(async () => {
+		const [{ getMetaDir }, { runSetupGithubActionsCommand }] = await Promise.all([import("./cli-support-CHEYZ9xj.mjs"), import("./setup-github-actions-emXSyGy3.mjs")]);
 		await runSetupGithubActionsCommand(process.cwd(), getMetaDir());
 	});
 	cli.command("help [command]", "Display help for a command").action((commandName) => {