@tanstack/intent 0.0.39 → 0.0.41

package/dist/artifact-coverage-CbZALe7Q.mjs

@@ -0,0 +1,3 @@
+import { t as readIntentArtifacts } from "./artifact-coverage-Cqphhpfo.mjs";
+
+export { readIntentArtifacts };

package/dist/{cli-support-Dmpj1iyQ.mjs → cli-support-BHoEb9y1.mjs}

@@ -1,5 +1,5 @@
-import { t as resolveProjectContext } from "./project-context-Dx6XIJJo.mjs";
-import { t as fail } from "./cli-error-BrMXlbtx.mjs";
+import { t as resolveProjectContext } from "./project-context-D4mFnCs7.mjs";
+import { t as fail } from "./cli-error-DOO5bLIG.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -31,7 +31,7 @@ function getCheckSkillsWorkflowAdvisories(root) {
 	return [`Intent workflow update available: run \`npx @tanstack/intent@latest setup\` to refresh ${relative(process.cwd(), workflowPath) || workflowPath}.`];
 }
 async function scanIntentsOrFail(options) {
-	const { scanForIntents } = await import("./scanner-BoB20xOF.mjs");
+	const { scanForIntents } = await import("./scanner-BWd4mS25.mjs");
 	try {
 		return scanForIntents(void 0, options);
 	} catch (err) {
@@ -68,18 +68,18 @@ async function resolveStaleTargets(targetDir) {
 		targetPath: targetDir
 	});
 	const workflowAdvisories = getCheckSkillsWorkflowAdvisories(context.workspaceRoot ?? context.packageRoot ?? resolvedRoot);
-	const { buildWorkspaceCoverageSignals, checkStaleness, readPackageName } = await import("./staleness-IIyVmUxU.mjs");
+	const { buildWorkspaceCoverageSignals, checkStaleness, readPackageName } = await import("./staleness-Dm4laJFc.mjs");
 	const isWorkspaceRootTarget = context.workspaceRoot !== null && resolvedRoot === context.workspaceRoot;
 	if (context.packageRoot && !isWorkspaceRootTarget && (context.targetSkillsDir !== null || context.workspaceRoot === null)) return {
 		reports: [await checkStaleness(context.packageRoot, readPackageName(context.packageRoot), context.workspaceRoot ?? context.packageRoot)],
 		workflowAdvisories
 	};
-	const { findWorkspaceRoot, getWorkspaceInfo } = await import("./workspace-patterns-BWMz7TsI.mjs");
+	const { findWorkspaceRoot, getWorkspaceInfo } = await import("./workspace-patterns-CA-UGM5C.mjs");
 	const workspaceRoot = findWorkspaceRoot(resolvedRoot);
 	const workspaceInfo = workspaceRoot ? getWorkspaceInfo(workspaceRoot) : null;
 	if (workspaceInfo) {
 		const reports = await Promise.all(workspaceInfo.packageDirsWithSkills.map((packageDir) => checkStaleness(packageDir, readPackageName(packageDir), workspaceInfo.root)));
-		const { readIntentArtifacts } = await import("./artifact-coverage-DA26utB1.mjs");
+		const { readIntentArtifacts } = await import("./artifact-coverage-CbZALe7Q.mjs");
 		const artifacts = existsSync(join(workspaceInfo.root, "_artifacts")) ? readIntentArtifacts(workspaceInfo.root) : null;
 		const coverageSignals = buildWorkspaceCoverageSignals({
 			artifactRoot: workspaceInfo.root,

package/dist/{cli-support-OrWuIzI3.mjs → cli-support-BxF1HIpw.mjs}

@@ -1,6 +1,6 @@
-import "./utils-mdb4i6VA.mjs";
-import "./workspace-patterns-BZLEaMcS.mjs";
-import "./project-context-Dx6XIJJo.mjs";
-import { a as printDebugInfo, c as scanOptionsFromGlobalFlags, i as getMetaDir, l as printWarnings, n as coreOptionsFromGlobalFlags, o as resolveStaleTargets, r as getCheckSkillsWorkflowAdvisories, s as scanIntentsOrFail, t as INTENT_CHECK_SKILLS_WORKFLOW_VERSION } from "./cli-support-Dmpj1iyQ.mjs";
+import "./utils-Chn-30vI.mjs";
+import "./workspace-patterns-C5O4Dfpl.mjs";
+import "./project-context-D4mFnCs7.mjs";
+import { a as printDebugInfo, c as scanOptionsFromGlobalFlags, i as getMetaDir, l as printWarnings, n as coreOptionsFromGlobalFlags, o as resolveStaleTargets, r as getCheckSkillsWorkflowAdvisories, s as scanIntentsOrFail, t as INTENT_CHECK_SKILLS_WORKFLOW_VERSION } from "./cli-support-BHoEb9y1.mjs";
 
 export { INTENT_CHECK_SKILLS_WORKFLOW_VERSION, coreOptionsFromGlobalFlags, getCheckSkillsWorkflowAdvisories, getMetaDir, printDebugInfo, printWarnings, resolveStaleTargets, scanIntentsOrFail, scanOptionsFromGlobalFlags };

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as isCliFailure, t as fail } from "./cli-error-BrMXlbtx.mjs";
+import { n as isCliFailure, t as fail } from "./cli-error-DOO5bLIG.mjs";
 import { realpathSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { cac } from "cac";
@@ -9,43 +9,43 @@ 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] [--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-DNPHxYpR.mjs");
+		const { runListCommand } = await import("./list-CpOcnLWv.mjs");
 		await runListCommand(options);
 	});
 	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-CK7vr50h.mjs");
+		const { runLoadCommand } = await import("./load-BxmN8f0E.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-OrWuIzI3.mjs"), import("./meta-CYV9EzM8.mjs")]);
+		const [{ getMetaDir }, { runMetaCommand }] = await Promise.all([import("./cli-support-BxF1HIpw.mjs"), import("./meta-Dstclm2x.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-BYUd0qb8.mjs");
+		const { runValidateCommand } = await import("./validate-CTSG3eDc.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-OrWuIzI3.mjs"), import("./install-Brf5PORN.mjs")]);
+		const [{ scanIntentsOrFail }, { runInstallCommand }] = await Promise.all([import("./cli-support-BxF1HIpw.mjs"), import("./install-EVdqAy8f.mjs")]);
 		await runInstallCommand(options, scanIntentsOrFail);
 	});
 	cli.command("scaffold", "Print maintainer scaffold prompt").usage("scaffold").action(async () => {
-		const [{ getMetaDir }, { runScaffoldCommand }] = await Promise.all([import("./cli-support-OrWuIzI3.mjs"), import("./scaffold-D2vwv9ls.mjs")]);
+		const [{ getMetaDir }, { runScaffoldCommand }] = await Promise.all([import("./cli-support-BxF1HIpw.mjs"), import("./scaffold-CaShIIUY.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-OrWuIzI3.mjs"), import("./stale-flPZnWfI.mjs")]);
+		const [{ resolveStaleTargets }, { runStaleCommand }] = await Promise.all([import("./cli-support-BxF1HIpw.mjs"), import("./stale-BD77r7KR.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");
+		const { runEditPackageJsonCommand } = await import("./edit-package-json-cPClxVZZ.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-OrWuIzI3.mjs"), import("./setup-github-actions-emXSyGy3.mjs")]);
+		const [{ getMetaDir }, { runSetupGithubActionsCommand }] = await Promise.all([import("./cli-support-BxF1HIpw.mjs"), import("./setup-github-actions-zzLUbyAL.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-OrWuIzI3.mjs"), import("./setup-github-actions-emXSyGy3.mjs")]);
+		const [{ getMetaDir }, { runSetupGithubActionsCommand }] = await Promise.all([import("./cli-support-BxF1HIpw.mjs"), import("./setup-github-actions-zzLUbyAL.mjs")]);
 		await runSetupGithubActionsCommand(process.cwd(), getMetaDir());
 	});
 	cli.command("help [command]", "Display help for a command").action((commandName) => {

package/dist/command-runner-DJTliSTc.mjs

@@ -0,0 +1,16 @@
+//#region src/command-runner.ts
+const runnerByPackageManager = {
+	bun: "bunx @tanstack/intent@latest",
+	npm: "npx @tanstack/intent@latest",
+	pnpm: "pnpm dlx @tanstack/intent@latest",
+	unknown: "npx @tanstack/intent@latest",
+	yarn: "yarn dlx @tanstack/intent@latest"
+};
+function formatIntentCommand(packageManager, args) {
+	const command = runnerByPackageManager[packageManager];
+	const trimmedArgs = args.trim();
+	return trimmedArgs ? `${command} ${trimmedArgs}` : command;
+}
+
+//#endregion
+export { formatIntentCommand as t };

package/dist/{core-0H8zUKIh.mjs → core-DEiRgUqe.mjs}

@@ -1,9 +1,9 @@
-import { o as resolveDepDir, r as getDeps, s as toPosixPath } from "./utils-mdb4i6VA.mjs";
-import { n as scanIntentPackageAtRoot, t as scanForIntents } from "./scanner-BaOA18pn.mjs";
-import { o as resolveWorkspacePackages } from "./workspace-patterns-BZLEaMcS.mjs";
-import { i as parseSkillUse, n as formatSkillUse } from "./skill-use-umYvZl94.mjs";
-import { t as resolveProjectContext } from "./project-context-Dx6XIJJo.mjs";
-import { a as compileExcludePatterns, c as warningMentionsPackage, i as resolveSkillUse, l as readPackageJson, o as getEffectiveExcludePatterns, r as resolveSkillEntry, s as isPackageExcluded, t as ResolveSkillUseError } from "./resolver-CP0S8UjZ.mjs";
+import { c as resolveDepDir, i as getDeps, l as toPosixPath } from "./utils-Chn-30vI.mjs";
+import { n as scanIntentPackageAtRoot, r as createIntentFsCache, t as scanForIntents } from "./scanner-B6nnctK4.mjs";
+import { n as findWorkspacePackages } from "./workspace-patterns-C5O4Dfpl.mjs";
+import { i as parseSkillUse, n as formatSkillUse } from "./skill-use-C0q2MEEX.mjs";
+import { t as resolveProjectContext } from "./project-context-D4mFnCs7.mjs";
+import { a as compileExcludePatterns, c as warningMentionsPackage, i as resolveSkillUse, o as getEffectiveExcludePatterns, r as resolveSkillEntry, s as isPackageExcluded, t as ResolveSkillUseError } from "./resolver-B36uOK8c.mjs";
 import { existsSync, readFileSync, realpathSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 
@@ -213,15 +213,15 @@ function rewriteLoadedSkillMarkdownDestinations({ content, cwd, packageRoot, ski
 
 //#endregion
 //#region src/core/load-resolution.ts
-function readWorkspacePackageInfos(context) {
+function readWorkspacePackageInfos(context, fsCache) {
 	const dirs = /* @__PURE__ */ new Set();
 	if (context.packageRoot) dirs.add(context.packageRoot);
 	if (context.workspaceRoot) {
 		dirs.add(context.workspaceRoot);
-		for (const dir of resolveWorkspacePackages(context.workspaceRoot, context.workspacePatterns)) dirs.add(dir);
+		for (const dir of findWorkspacePackages(context.workspaceRoot)) dirs.add(dir);
 	}
 	return [...dirs].flatMap((dir) => {
-		const packageJson = readPackageJson(dir);
+		const packageJson = fsCache.readPackageJson(dir);
 		if (!packageJson) return [];
 		return [{
 			dir,
@@ -270,10 +270,10 @@ function getDirectLoadFastPathCandidateDirs(packageName, context, cwd) {
 	if (context.workspaceRoot && context.workspaceRoot !== context.packageRoot) addCandidateDir(candidates, seen, resolveDependencyPackageDir(packageName, context.workspaceRoot));
 	return candidates;
 }
-function getWorkspaceLoadFastPathCandidateDirs(packageName, context) {
+function getWorkspaceLoadFastPathCandidateDirs(packageName, context, fsCache) {
 	const candidates = [];
 	const seen = /* @__PURE__ */ new Set();
-	const workspacePackages = readWorkspacePackageInfos(context);
+	const workspacePackages = readWorkspacePackageInfos(context, fsCache);
 	for (const pkg of workspacePackages) if (pkg.name === packageName) addCandidateDir(candidates, seen, pkg.dir);
 	for (const pkg of workspacePackages) {
 		if (!workspacePackageDeclaresDependency(pkg.packageJson, packageName)) continue;
@@ -297,10 +297,11 @@ function resolveScannedPackageSkill(scanned, parsedUse) {
 		conflict: null
 	};
 }
-function resolveFromPackageRoots(packageRoots, parsedUse, cwd) {
+function resolveFromPackageRoots(packageRoots, parsedUse, cwd, fsCache) {
 	for (const packageRoot of packageRoots) {
 		const scanned = scanIntentPackageAtRoot(packageRoot, {
 			fallbackName: parsedUse.packageName,
+			fsCache,
 			projectRoot: cwd,
 			skillNameHint: parsedUse.skillName
 		});
@@ -309,6 +310,7 @@ function resolveFromPackageRoots(packageRoots, parsedUse, cwd) {
 		if (scanned.package?.name === parsedUse.packageName) {
 			const fallbackResolved = resolveScannedPackageSkill(scanIntentPackageAtRoot(packageRoot, {
 				fallbackName: parsedUse.packageName,
+				fsCache,
 				projectRoot: cwd
 			}), parsedUse);
 			if (fallbackResolved) return fallbackResolved;
@@ -316,13 +318,13 @@ function resolveFromPackageRoots(packageRoots, parsedUse, cwd) {
 	}
 	return null;
 }
-function resolveSkillUseFastPath(parsedUse, options, context = resolveProjectContext({ cwd: process.cwd() }), cwd = context.cwd) {
+function resolveSkillUseFastPath(parsedUse, options, context = resolveProjectContext({ cwd: process.cwd() }), cwd = context.cwd, fsCache = createIntentFsCache()) {
 	if (options.globalOnly) return null;
 	if (shouldSkipFastPathForYarnPnp(context, cwd)) return null;
-	const directResolved = resolveFromPackageRoots(getDirectLoadFastPathCandidateDirs(parsedUse.packageName, context, cwd), parsedUse, cwd);
+	const directResolved = resolveFromPackageRoots(getDirectLoadFastPathCandidateDirs(parsedUse.packageName, context, cwd), parsedUse, cwd, fsCache);
 	if (directResolved) return directResolved;
 	if (!context.workspaceRoot) return null;
-	return resolveFromPackageRoots(getWorkspaceLoadFastPathCandidateDirs(parsedUse.packageName, context), parsedUse, cwd);
+	return resolveFromPackageRoots(getWorkspaceLoadFastPathCandidateDirs(parsedUse.packageName, context, fsCache), parsedUse, cwd, fsCache);
 }
 
 //#endregion
@@ -344,32 +346,41 @@ function toScanOptions(options) {
 function getScanScope(options) {
 	return options.scope ?? (options.includeGlobal ? "local-and-global" : "local");
 }
+function withFsCache(options, fsCache) {
+	return {
+		...options,
+		fsCache
+	};
+}
 function resolveCoreCwd(options) {
 	return resolve(process.cwd(), options.cwd ?? process.cwd());
 }
 function listIntentSkills(options = {}) {
 	const cwd = resolveCoreCwd(options);
 	const scanOptions = toScanOptions(options);
+	const fsCache = createIntentFsCache();
 	const projectContext = resolveProjectContext({ cwd });
-	const scanResult = scanForIntents(cwd, scanOptions);
+	const scanResult = scanForIntents(cwd, withFsCache(scanOptions, fsCache));
 	const excludePatterns = getEffectiveExcludePatterns(options, projectContext);
 	const excludeMatchers = compileExcludePatterns(excludePatterns);
 	const excludedPackages = scanResult.packages.filter((pkg) => isPackageExcluded(pkg.name, excludeMatchers)).map((pkg) => pkg.name);
 	const packages = scanResult.packages.filter((pkg) => !isPackageExcluded(pkg.name, excludeMatchers));
+	const skills = packages.flatMap((pkg) => pkg.skills.map((skill) => {
+		return {
+			use: formatSkillUse(pkg.name, skill.name),
+			packageName: pkg.name,
+			packageRoot: pkg.packageRoot,
+			packageVersion: pkg.version,
+			packageSource: pkg.source,
+			skillName: skill.name,
+			description: skill.description,
+			type: skill.type,
+			framework: skill.framework
+		};
+	}));
 	const result = {
-		skills: packages.flatMap((pkg) => pkg.skills.map((skill) => {
-			return {
-				use: formatSkillUse(pkg.name, skill.name),
-				packageName: pkg.name,
-				packageRoot: pkg.packageRoot,
-				packageVersion: pkg.version,
-				packageSource: pkg.source,
-				skillName: skill.name,
-				description: skill.description,
-				type: skill.type,
-				framework: skill.framework
-			};
-		})),
+		packageManager: scanResult.packageManager,
+		skills,
 		packages: packages.map((pkg) => ({
 			name: pkg.name,
 			version: pkg.version,
@@ -387,7 +398,8 @@ function listIntentSkills(options = {}) {
 		packageCount: result.packages.length,
 		skillCount: result.skills.length,
 		warningCount: result.warnings.length,
-		conflictCount: result.conflicts.length
+		conflictCount: result.conflicts.length,
+		scan: scanResult.stats ?? fsCache.getStats()
 	};
 	return result;
 }
@@ -424,7 +436,7 @@ function toResolvedIntentSkill(cwd, use, resolved, debug) {
 		result
 	};
 }
-function createLoadedSkillDebug({ cwd, excludes, resolution, resolved, scope }) {
+function createLoadedSkillDebug({ cwd, excludes, scan, resolution, resolved, scope }) {
 	return {
 		cwd,
 		scope,
@@ -435,7 +447,8 @@ function createLoadedSkillDebug({ cwd, excludes, resolution, resolved, scope })
 		version: resolved.version,
 		source: resolved.source,
 		path: resolved.path,
-		warningCount: resolved.warnings.length
+		warningCount: resolved.warnings.length,
+		scan
 	};
 }
 function resolveIntentSkillInCwd(cwd, use, options = {}) {
@@ -445,21 +458,23 @@ function resolveIntentSkillInCwd(cwd, use, options = {}) {
 	} catch (err) {
 		throw new IntentCoreError("invalid-skill-use", err instanceof Error ? err.message : String(err));
 	}
+	const fsCache = createIntentFsCache();
 	const projectContext = resolveProjectContext({ cwd });
 	const excludePatterns = getEffectiveExcludePatterns(options, projectContext);
 	const excludeMatchers = compileExcludePatterns(excludePatterns);
 	if (isPackageExcluded(parsedUse.packageName, excludeMatchers)) throw new IntentCoreError("package-excluded", `Cannot load skill use "${use}": package "${parsedUse.packageName}" is excluded by Intent configuration.`);
 	const scanOptions = toScanOptions(options);
 	const scope = getScanScope(scanOptions);
-	const fastPathResolved = resolveSkillUseFastPath(parsedUse, options, projectContext, cwd);
+	const fastPathResolved = resolveSkillUseFastPath(parsedUse, options, projectContext, cwd, fsCache);
 	if (fastPathResolved) return toResolvedIntentSkill(cwd, use, fastPathResolved, options.debug ? createLoadedSkillDebug({
 		cwd,
 		excludes: excludePatterns,
 		resolution: "fast-path",
 		resolved: fastPathResolved,
+		scan: fsCache.getStats(),
 		scope
 	}) : void 0);
-	const scanResult = scanForIntents(cwd, scanOptions);
+	const scanResult = scanForIntents(cwd, withFsCache(scanOptions, fsCache));
 	let resolved;
 	try {
 		resolved = resolveSkillUse(use, scanResult);
@@ -472,6 +487,7 @@ function resolveIntentSkillInCwd(cwd, use, options = {}) {
 		excludes: excludePatterns,
 		resolution: "full-scan",
 		resolved,
+		scan: scanResult.stats ?? fsCache.getStats(),
 		scope
 	}) : void 0);
 }

package/dist/core.d.mts

@@ -1,4 +1,4 @@
-import { b as VersionConflict, h as ScanScope, l as IntentPackage } from "./types-S2zpibHp.mjs";
+import { S as VersionConflict, _ as ScanStats, g as ScanScope, l as IntentPackage, p as PackageManager } from "./types-DU_Z0qNT.mjs";
 
 //#region src/core/types.d.ts
 interface IntentCoreOptions {
@@ -27,6 +27,7 @@ interface IntentPackageSummary {
   skillCount: number;
 }
 interface IntentSkillList {
+  packageManager: PackageManager;
   skills: Array<IntentSkillSummary>;
   packages: Array<IntentPackageSummary>;
   warnings: Array<string>;
@@ -55,6 +56,7 @@ interface IntentSkillListDebug {
   skillCount: number;
   warningCount: number;
   conflictCount: number;
+  scan: IntentScanDebugStats;
 }
 interface LoadedIntentSkillDebug {
   cwd: string;
@@ -67,7 +69,9 @@ interface LoadedIntentSkillDebug {
   source: IntentPackage['source'];
   path: string;
   warningCount: number;
+  scan: IntentScanDebugStats;
 }
+interface IntentScanDebugStats extends ScanStats {}
 type IntentCoreErrorCode = 'invalid-options' | 'invalid-skill-use' | 'package-not-found' | 'package-excluded' | 'skill-not-found' | 'skill-path-outside-package' | 'skill-file-not-found';
 //#endregion
 //#region src/core.d.ts

package/dist/core.mjs

@@ -1,9 +1,9 @@
-import "./utils-mdb4i6VA.mjs";
-import "./skill-paths-DNOHrvL5.mjs";
-import "./scanner-BaOA18pn.mjs";
-import "./workspace-patterns-BZLEaMcS.mjs";
-import "./project-context-Dx6XIJJo.mjs";
-import "./resolver-CP0S8UjZ.mjs";
-import { i as resolveIntentSkill, n as listIntentSkills, r as loadIntentSkill, t as IntentCoreError } from "./core-0H8zUKIh.mjs";
+import "./utils-Chn-30vI.mjs";
+import "./skill-paths-4kQXfQXo.mjs";
+import "./scanner-B6nnctK4.mjs";
+import "./workspace-patterns-C5O4Dfpl.mjs";
+import "./project-context-D4mFnCs7.mjs";
+import "./resolver-B36uOK8c.mjs";
+import { i as resolveIntentSkill, n as listIntentSkills, r as loadIntentSkill, t as IntentCoreError } from "./core-DEiRgUqe.mjs";
 
 export { IntentCoreError, listIntentSkills, loadIntentSkill, resolveIntentSkill };

package/dist/{display-CVeoAwBd.mjs → display-BPM-AJGc.mjs}

@@ -1,4 +1,4 @@
-import { n as isStableLoadPath, t as formatRuntimeSkillLookupHint } from "./skill-paths-DNOHrvL5.mjs";
+import { n as isStableLoadPath, t as formatRuntimeSkillLookupHint } from "./skill-paths-4kQXfQXo.mjs";
 
 //#region src/display.ts
 function padColumn(text, width) {
@@ -17,6 +17,7 @@ function printSkillLine(displayName, skill, indent, opts) {
 	const padding = " ".repeat(Math.max(2, opts.nameWidth - nameStr.length));
 	const typeCol = opts.showTypes ? (skill.type ? `[${skill.type}]` : "").padEnd(14) : "";
 	console.log(`${nameStr}${padding}${typeCol}${skill.description}`);
+	if (skill.loadCommand) console.log(`${" ".repeat(indent + 2)}Load: ${skill.loadCommand}`);
 	if (skill.path) {
 		const pathIndent = " ".repeat(indent + 2);
 		if (isStableLoadPath(skill.path)) console.log(`${pathIndent}${skill.path}`);
@@ -29,6 +30,7 @@ function printSkillLine(displayName, skill, indent, opts) {
 function printSkillTree(skills, opts) {
 	const roots = [];
 	const children = /* @__PURE__ */ new Map();
+	const printedSkills = /* @__PURE__ */ new Set();
 	for (const skill of skills) {
 		const slashIdx = skill.name.indexOf("/");
 		if (slashIdx === -1) roots.push(skill.name);
@@ -45,7 +47,15 @@ function printSkillTree(skills, opts) {
 		const rootSkill = skills.find((s) => s.name === rootName);
 		if (!rootSkill) continue;
 		printSkillLine(rootName, rootSkill, 4, opts);
-		for (const sub of children.get(rootName) ?? []) printSkillLine(sub.name.slice(sub.name.indexOf("/") + 1), sub, 6, opts);
+		printedSkills.add(rootSkill.name);
+		for (const sub of children.get(rootName) ?? []) {
+			printSkillLine(sub.name.slice(sub.name.indexOf("/") + 1), sub, 6, opts);
+			printedSkills.add(sub.name);
+		}
+	}
+	for (const skill of skills) {
+		if (printedSkills.has(skill.name)) continue;
+		printSkillLine(skill.name, skill, 4, opts);
 	}
 }
 function computeSkillNameWidth(allPackageSkills) {

package/dist/display-lWCJg5Bo.mjs

@@ -0,0 +1,5 @@
+import "./utils-Chn-30vI.mjs";
+import "./skill-paths-4kQXfQXo.mjs";
+import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-BPM-AJGc.mjs";
+
+export { computeSkillNameWidth, printSkillTree, printTable };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { _ as SkillStaleness, a as IntentArtifactSet, b as VersionConflict, c as IntentConfig, d as MetaFeedbackPayload, f as MetaSkillName, g as SkillEntry, i as IntentArtifactFile, l as IntentPackage, m as ScanResult, n as FeedbackPayload, o as IntentArtifactSkill, p as ScanOptions, r as IntentArtifactCoverageIgnore, s as IntentArtifactWarning, t as AgentName, u as IntentProjectConfig, v as StalenessReport, y as StalenessSignal } from "./types-S2zpibHp.mjs";
-import { i as runEditPackageJson, o as runSetupGithubActions, r as SetupGithubActionsResult, t as EditPackageJsonResult } from "./setup-2SE9zYJk.mjs";
+import { S as VersionConflict, a as IntentArtifactSet, b as StalenessReport, c as IntentConfig, d as MetaFeedbackPayload, f as MetaSkillName, h as ScanResult, i as IntentArtifactFile, l as IntentPackage, m as ScanOptions, n as FeedbackPayload, o as IntentArtifactSkill, r as IntentArtifactCoverageIgnore, s as IntentArtifactWarning, t as AgentName, u as IntentProjectConfig, v as SkillEntry, x as StalenessSignal, y as SkillStaleness } from "./types-DU_Z0qNT.mjs";
+import { i as runEditPackageJson, o as runSetupGithubActions, r as SetupGithubActionsResult, t as EditPackageJsonResult } from "./setup-DL7qX_F-.mjs";
 
 //#region src/scanner.d.ts
 declare function scanForIntents(root?: string, options?: ScanOptions): ScanResult;

package/dist/index.mjs

@@ -1,14 +1,14 @@
-import { a as parseFrontmatter, n as findSkillFiles, o as resolveDepDir, r as getDeps } from "./utils-mdb4i6VA.mjs";
-import "./skill-paths-DNOHrvL5.mjs";
-import { t as scanForIntents } from "./scanner-BaOA18pn.mjs";
-import "./workspace-patterns-BZLEaMcS.mjs";
-import { t as readIntentArtifacts } from "./artifact-coverage-DgWuVqUp.mjs";
-import { n as checkStaleness } from "./staleness-V-nwqFUh.mjs";
-import { n as collectStaleReviewItems, r as createFailedStaleReviewItem, t as buildStaleReviewBody } from "./workflow-review-CwcR2ge4.mjs";
-import { i as parseSkillUse, n as formatSkillUse, r as isSkillUseParseError, t as SkillUseParseError } from "./skill-use-umYvZl94.mjs";
-import "./project-context-Dx6XIJJo.mjs";
-import { i as resolveSkillUse, n as isResolveSkillUseError, t as ResolveSkillUseError } from "./resolver-CP0S8UjZ.mjs";
-import { r as runSetupGithubActions, t as runEditPackageJson } from "./setup-kvWN4xCr.mjs";
+import { c as resolveDepDir, i as getDeps, r as findSkillFiles, s as parseFrontmatter } from "./utils-Chn-30vI.mjs";
+import "./skill-paths-4kQXfQXo.mjs";
+import { t as scanForIntents } from "./scanner-B6nnctK4.mjs";
+import "./workspace-patterns-C5O4Dfpl.mjs";
+import { t as readIntentArtifacts } from "./artifact-coverage-Cqphhpfo.mjs";
+import { n as checkStaleness } from "./staleness-DChVhbCN.mjs";
+import { n as collectStaleReviewItems, r as createFailedStaleReviewItem, t as buildStaleReviewBody } from "./workflow-review--Gc_yplP.mjs";
+import { i as parseSkillUse, n as formatSkillUse, r as isSkillUseParseError, t as SkillUseParseError } from "./skill-use-C0q2MEEX.mjs";
+import "./project-context-D4mFnCs7.mjs";
+import { i as resolveSkillUse, n as isResolveSkillUseError, t as ResolveSkillUseError } from "./resolver-B36uOK8c.mjs";
+import { r as runSetupGithubActions, t as runEditPackageJson } from "./setup-J4A9UfBB.mjs";
 import { readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { execFileSync, execSync } from "node:child_process";

package/dist/{install-7BAmUZFB.mjs → install-DCiBBx55.mjs}

@@ -1,6 +1,8 @@
-import { i as parseSkillUse, n as formatSkillUse } from "./skill-use-umYvZl94.mjs";
-import { t as fail } from "./cli-error-BrMXlbtx.mjs";
-import { c as scanOptionsFromGlobalFlags, l as printWarnings } from "./cli-support-Dmpj1iyQ.mjs";
+import { t as detectPackageManager } from "./package-manager-DDZck142.mjs";
+import { i as parseSkillUse, n as formatSkillUse } from "./skill-use-C0q2MEEX.mjs";
+import { t as fail } from "./cli-error-DOO5bLIG.mjs";
+import { t as formatIntentCommand } from "./command-runner-DJTliSTc.mjs";
+import { c as scanOptionsFromGlobalFlags, l as printWarnings } from "./cli-support-BHoEb9y1.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join, relative } from "node:path";
 import { parse } from "yaml";
@@ -126,7 +128,7 @@ function formatWhen(packageName, skill) {
 function buildIntentSkillsBlock(scanResult) {
 	const lines = [
 		INTENT_SKILLS_START,
-		"# Skill mappings - load `use` with `npx @tanstack/intent@latest load <use>`.",
+		`# Skill mappings - load \`use\` with \`${formatIntentCommand(scanResult.packageManager, "load <use>")}\`.`,
 		"skills:"
 	];
 	let mappingCount = 0;
@@ -143,15 +145,17 @@ function buildIntentSkillsBlock(scanResult) {
 		mappingCount
 	};
 }
-function buildIntentSkillGuidanceBlock() {
+function buildIntentSkillGuidanceBlock(packageManager = "unknown") {
+	const listCommand = formatIntentCommand(packageManager, "list");
+	const loadCommand = formatIntentCommand(packageManager, "load <package>#<skill>");
 	return {
 		block: `${[
 			INTENT_SKILLS_START,
 			"## Skill Loading",
 			"",
 			"Before substantial work:",
-			"- Skill check: run `npx @tanstack/intent@latest list`, or use skills already listed in context.",
-			"- Skill guidance: if one local skill clearly matches the task, run `npx @tanstack/intent@latest load <package>#<skill>` and follow the returned `SKILL.md`.",
+			`- Skill check: run \`${listCommand}\`, or use skills already listed in context.`,
+			`- Skill guidance: if one local skill clearly matches the task, run \`${loadCommand}\` and follow the returned \`SKILL.md\`.`,
 			"- Monorepos: when working across packages, run the skill check from the workspace root and prefer the local skill for the package being changed.",
 			"- Multiple matches: prefer the most specific local skill for the package or concern you are changing; load additional skills only when the task spans multiple packages or concerns.",
 			INTENT_SKILLS_END
@@ -376,9 +380,9 @@ async function runInstallCommand(options, scanIntentsOrFail) {
 		console.log(INSTALL_PROMPT);
 		return;
 	}
-	scanOptionsFromGlobalFlags(options);
+	const scanOptions = scanOptionsFromGlobalFlags(options);
 	if (!options.map) {
-		const generated$1 = buildIntentSkillGuidanceBlock();
+		const generated$1 = buildIntentSkillGuidanceBlock(detectPackageManager());
 		if (options.dryRun) {
 			const targetPath = resolveIntentSkillsBlockTargetPath(process.cwd(), 1);
 			console.log(`Generated skill loading guidance for ${formatTargetPath(targetPath)}.`);
@@ -401,7 +405,7 @@ async function runInstallCommand(options, scanIntentsOrFail) {
 		printPlacementTip(result$1.targetPath);
 		return;
 	}
-	const scanResult = await scanIntentsOrFail(scanOptionsFromGlobalFlags(options));
+	const scanResult = await scanIntentsOrFail(scanOptions);
 	const generated = buildIntentSkillsBlock(scanResult);
 	if (options.dryRun) {
 		const targetPath = resolveIntentSkillsBlockTargetPath(process.cwd(), generated.mappingCount);

package/dist/install-EVdqAy8f.mjs

@@ -0,0 +1,7 @@
+import "./utils-Chn-30vI.mjs";
+import "./workspace-patterns-C5O4Dfpl.mjs";
+import "./project-context-D4mFnCs7.mjs";
+import "./cli-support-BHoEb9y1.mjs";
+import { n as runInstallCommand, t as INSTALL_PROMPT } from "./install-DCiBBx55.mjs";
+
+export { INSTALL_PROMPT, runInstallCommand };

package/dist/intent-library.mjs

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import "./utils-mdb4i6VA.mjs";
-import "./skill-paths-DNOHrvL5.mjs";
-import "./workspace-patterns-BZLEaMcS.mjs";
-import "./project-context-Dx6XIJJo.mjs";
-import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-CVeoAwBd.mjs";
-import "./cli-support-Dmpj1iyQ.mjs";
-import { t as INSTALL_PROMPT } from "./install-7BAmUZFB.mjs";
-import { t as scanLibrary } from "./library-scanner-CHepLJQJ.mjs";
+import "./utils-Chn-30vI.mjs";
+import "./skill-paths-4kQXfQXo.mjs";
+import "./workspace-patterns-C5O4Dfpl.mjs";
+import "./project-context-D4mFnCs7.mjs";
+import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-BPM-AJGc.mjs";
+import "./cli-support-BHoEb9y1.mjs";
+import { t as INSTALL_PROMPT } from "./install-DCiBBx55.mjs";
+import { t as scanLibrary } from "./library-scanner-BpEuR__1.mjs";
 
 //#region src/intent-library.ts
 function cmdList() {

package/dist/{library-scanner-CHepLJQJ.mjs → library-scanner-BpEuR__1.mjs}

@@ -1,5 +1,5 @@
-import { a as parseFrontmatter, o as resolveDepDir, r as getDeps, s as toPosixPath } from "./utils-mdb4i6VA.mjs";
-import { r as rewriteSkillLoadPaths } from "./skill-paths-DNOHrvL5.mjs";
+import { c as resolveDepDir, i as getDeps, l as toPosixPath, s as parseFrontmatter } from "./utils-Chn-30vI.mjs";
+import { r as rewriteSkillLoadPaths } from "./skill-paths-4kQXfQXo.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { dirname, join, relative } from "node:path";
 

package/dist/library-scanner.d.mts

@@ -1,4 +1,4 @@
-import { g as SkillEntry } from "./types-S2zpibHp.mjs";
+import { v as SkillEntry } from "./types-DU_Z0qNT.mjs";
 
 //#region src/library-scanner.d.ts
 interface LibraryPackage {

package/dist/library-scanner.mjs

@@ -1,5 +1,5 @@
-import "./utils-mdb4i6VA.mjs";
-import "./skill-paths-DNOHrvL5.mjs";
-import { t as scanLibrary } from "./library-scanner-CHepLJQJ.mjs";
+import "./utils-Chn-30vI.mjs";
+import "./skill-paths-4kQXfQXo.mjs";
+import { t as scanLibrary } from "./library-scanner-BpEuR__1.mjs";
 
 export { scanLibrary };