@tanstack/intent 0.0.38 → 0.0.40

package/dist/{cli-support-BlSsqyx7.mjs → cli-support-Cb9lNXhL.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-BON5hn4L.mjs";
+import "./utils-BPDvfmcd.mjs";
+import "./workspace-patterns-CIJQCwbJ.mjs";
+import "./project-context-Bv9BDh8B.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-DtqVDiJv.mjs";
 
 export { INTENT_CHECK_SKILLS_WORKFLOW_VERSION, coreOptionsFromGlobalFlags, getCheckSkillsWorkflowAdvisories, getMetaDir, printDebugInfo, printWarnings, resolveStaleTargets, scanIntentsOrFail, scanOptionsFromGlobalFlags };

package/dist/{cli-support-BON5hn4L.mjs → cli-support-DtqVDiJv.mjs}

@@ -1,4 +1,4 @@
-import { t as resolveProjectContext } from "./project-context-Dx6XIJJo.mjs";
+import { t as resolveProjectContext } from "./project-context-Bv9BDh8B.mjs";
 import { t as fail } from "./cli-error-BrMXlbtx.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join, relative, resolve } from "node:path";
@@ -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-ByG70-E3.mjs");
+	const { scanForIntents } = await import("./scanner-Ix6MmxfB.mjs");
 	try {
 		return scanForIntents(void 0, options);
 	} catch (err) {
@@ -68,13 +68,13 @@ async function resolveStaleTargets(targetDir) {
 		targetPath: targetDir
 	});
 	const workflowAdvisories = getCheckSkillsWorkflowAdvisories(context.workspaceRoot ?? context.packageRoot ?? resolvedRoot);
-	const { buildWorkspaceCoverageSignals, checkStaleness, readPackageName } = await import("./staleness-DpyuNdd5.mjs");
+	const { buildWorkspaceCoverageSignals, checkStaleness, readPackageName } = await import("./staleness-Dl-m8JWM.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-Diy5gtz_.mjs");
 	const workspaceRoot = findWorkspaceRoot(resolvedRoot);
 	const workspaceInfo = workspaceRoot ? getWorkspaceInfo(workspaceRoot) : null;
 	if (workspaceInfo) {

package/dist/cli.mjs

@@ -9,31 +9,31 @@ 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-iLIL-EO3.mjs");
+		const { runListCommand } = await import("./list-CxSm8YYl.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-8868G50-.mjs");
+		const { runLoadCommand } = await import("./load-DF-zIT3-.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-BlSsqyx7.mjs"), import("./meta-CYV9EzM8.mjs")]);
+		const [{ getMetaDir }, { runMetaCommand }] = await Promise.all([import("./cli-support-Cb9lNXhL.mjs"), import("./meta-BNSVXFQu.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-BL1SYAwh.mjs");
+		const { runValidateCommand } = await import("./validate-Divq4AiV.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-BlSsqyx7.mjs"), import("./install-RZpz279M.mjs")]);
+		const [{ scanIntentsOrFail }, { runInstallCommand }] = await Promise.all([import("./cli-support-Cb9lNXhL.mjs"), import("./install-ChddjnhO.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-BlSsqyx7.mjs"), import("./scaffold-D2vwv9ls.mjs")]);
+		const [{ getMetaDir }, { runScaffoldCommand }] = await Promise.all([import("./cli-support-Cb9lNXhL.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-BlSsqyx7.mjs"), import("./stale-flPZnWfI.mjs")]);
+		const [{ resolveStaleTargets }, { runStaleCommand }] = await Promise.all([import("./cli-support-Cb9lNXhL.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 () => {
@@ -41,11 +41,11 @@ function createCli() {
 		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-BlSsqyx7.mjs"), import("./setup-github-actions-emXSyGy3.mjs")]);
+		const [{ getMetaDir }, { runSetupGithubActionsCommand }] = await Promise.all([import("./cli-support-Cb9lNXhL.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-BlSsqyx7.mjs"), import("./setup-github-actions-emXSyGy3.mjs")]);
+		const [{ getMetaDir }, { runSetupGithubActionsCommand }] = await Promise.all([import("./cli-support-Cb9lNXhL.mjs"), import("./setup-github-actions-emXSyGy3.mjs")]);
 		await runSetupGithubActionsCommand(process.cwd(), getMetaDir());
 	});
 	cli.command("help [command]", "Display help for a command").action((commandName) => {

package/dist/{core-baYs6H7Z.mjs → core-BOSjgetf.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-DwYsjXzI.mjs";
-import { o as resolveWorkspacePackages } from "./workspace-patterns-BZLEaMcS.mjs";
+import { o as resolveDepDir, r as getDeps, s as toPosixPath } from "./utils-BPDvfmcd.mjs";
+import { n as scanIntentPackageAtRoot, r as createIntentFsCache, t as scanForIntents } from "./scanner-BGyQTQ3U.mjs";
+import { n as findWorkspacePackages } from "./workspace-patterns-CIJQCwbJ.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 { t as resolveProjectContext } from "./project-context-Bv9BDh8B.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-BDsZ3kWg.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,14 +346,21 @@ 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);
@@ -387,7 +396,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 +434,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 +445,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 +456,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 +485,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 { g as ScanStats, h as ScanScope, l as IntentPackage, x as VersionConflict } from "./types-Cq5cY9h9.mjs";
 
 //#region src/core/types.d.ts
 interface IntentCoreOptions {
@@ -55,6 +55,7 @@ interface IntentSkillListDebug {
   skillCount: number;
   warningCount: number;
   conflictCount: number;
+  scan: IntentScanDebugStats;
 }
 interface LoadedIntentSkillDebug {
   cwd: string;
@@ -67,7 +68,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-DwYsjXzI.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-baYs6H7Z.mjs";
+import "./utils-BPDvfmcd.mjs";
+import "./skill-paths-BHbdWniB.mjs";
+import "./scanner-BGyQTQ3U.mjs";
+import "./workspace-patterns-CIJQCwbJ.mjs";
+import "./project-context-Bv9BDh8B.mjs";
+import "./resolver-BDsZ3kWg.mjs";
+import { i as resolveIntentSkill, n as listIntentSkills, r as loadIntentSkill, t as IntentCoreError } from "./core-BOSjgetf.mjs";
 
 export { IntentCoreError, listIntentSkills, loadIntentSkill, resolveIntentSkill };

package/dist/display-CmLzVAae.mjs

@@ -0,0 +1,5 @@
+import "./utils-BPDvfmcd.mjs";
+import "./skill-paths-BHbdWniB.mjs";
+import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-DHNuzSqR.mjs";
+
+export { computeSkillNameWidth, printSkillTree, printTable };

package/dist/{display-CVeoAwBd.mjs → display-DHNuzSqR.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-BHbdWniB.mjs";
 
 //#region src/display.ts
 function padColumn(text, width) {

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-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 { _ as SkillEntry, a as IntentArtifactSet, b as StalenessSignal, c as IntentConfig, d as MetaFeedbackPayload, f as MetaSkillName, 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 SkillStaleness, x as VersionConflict, y as StalenessReport } from "./types-Cq5cY9h9.mjs";
 import { i as runEditPackageJson, o as runSetupGithubActions, r as SetupGithubActionsResult, t as EditPackageJsonResult } from "./setup-2SE9zYJk.mjs";
 
 //#region src/scanner.d.ts

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-DwYsjXzI.mjs";
-import "./workspace-patterns-BZLEaMcS.mjs";
+import { a as parseFrontmatter, n as findSkillFiles, o as resolveDepDir, r as getDeps } from "./utils-BPDvfmcd.mjs";
+import "./skill-paths-BHbdWniB.mjs";
+import { t as scanForIntents } from "./scanner-BGyQTQ3U.mjs";
+import "./workspace-patterns-CIJQCwbJ.mjs";
 import { t as readIntentArtifacts } from "./artifact-coverage-DgWuVqUp.mjs";
-import { n as checkStaleness } from "./staleness-CFr3W-RI.mjs";
+import { n as checkStaleness } from "./staleness-CGLs-swr.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 "./project-context-Bv9BDh8B.mjs";
+import { i as resolveSkillUse, n as isResolveSkillUseError, t as ResolveSkillUseError } from "./resolver-BDsZ3kWg.mjs";
+import { r as runSetupGithubActions, t as runEditPackageJson } from "./setup-DQMKxEoA.mjs";
 import { readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { execFileSync, execSync } from "node:child_process";

package/dist/{install-BPWtaOuo.mjs → install-CLkmoPOY.mjs}

@@ -1,6 +1,6 @@
 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-BON5hn4L.mjs";
+import { c as scanOptionsFromGlobalFlags, l as printWarnings } from "./cli-support-DtqVDiJv.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join, relative } from "node:path";
 import { parse } from "yaml";

package/dist/install-ChddjnhO.mjs

@@ -0,0 +1,7 @@
+import "./utils-BPDvfmcd.mjs";
+import "./workspace-patterns-CIJQCwbJ.mjs";
+import "./project-context-Bv9BDh8B.mjs";
+import "./cli-support-DtqVDiJv.mjs";
+import { n as runInstallCommand, t as INSTALL_PROMPT } from "./install-CLkmoPOY.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-BON5hn4L.mjs";
-import { t as INSTALL_PROMPT } from "./install-BPWtaOuo.mjs";
-import { t as scanLibrary } from "./library-scanner-CHepLJQJ.mjs";
+import "./utils-BPDvfmcd.mjs";
+import "./skill-paths-BHbdWniB.mjs";
+import "./workspace-patterns-CIJQCwbJ.mjs";
+import "./project-context-Bv9BDh8B.mjs";
+import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-DHNuzSqR.mjs";
+import "./cli-support-DtqVDiJv.mjs";
+import { t as INSTALL_PROMPT } from "./install-CLkmoPOY.mjs";
+import { t as scanLibrary } from "./library-scanner-BAJ7bXtW.mjs";
 
 //#region src/intent-library.ts
 function cmdList() {

package/dist/{library-scanner-CHepLJQJ.mjs → library-scanner-BAJ7bXtW.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 { a as parseFrontmatter, o as resolveDepDir, r as getDeps, s as toPosixPath } from "./utils-BPDvfmcd.mjs";
+import { r as rewriteSkillLoadPaths } from "./skill-paths-BHbdWniB.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 { _ as SkillEntry } from "./types-Cq5cY9h9.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-BPDvfmcd.mjs";
+import "./skill-paths-BHbdWniB.mjs";
+import { t as scanLibrary } from "./library-scanner-BAJ7bXtW.mjs";
 
 export { scanLibrary };

package/dist/{list-iLIL-EO3.mjs → list-CxSm8YYl.mjs}

@@ -1,11 +1,11 @@
-import "./utils-mdb4i6VA.mjs";
-import "./skill-paths-DNOHrvL5.mjs";
-import "./scanner-DwYsjXzI.mjs";
-import "./workspace-patterns-BZLEaMcS.mjs";
-import "./project-context-Dx6XIJJo.mjs";
-import "./resolver-CP0S8UjZ.mjs";
-import { a as printDebugInfo, l as printWarnings, n as coreOptionsFromGlobalFlags } from "./cli-support-BON5hn4L.mjs";
-import { n as listIntentSkills } from "./core-baYs6H7Z.mjs";
+import "./utils-BPDvfmcd.mjs";
+import "./skill-paths-BHbdWniB.mjs";
+import "./scanner-BGyQTQ3U.mjs";
+import "./workspace-patterns-CIJQCwbJ.mjs";
+import "./project-context-Bv9BDh8B.mjs";
+import "./resolver-BDsZ3kWg.mjs";
+import { a as printDebugInfo, l as printWarnings, n as coreOptionsFromGlobalFlags } from "./cli-support-DtqVDiJv.mjs";
+import { n as listIntentSkills } from "./core-BOSjgetf.mjs";
 
 //#region src/commands/list.ts
 function printListDebug(result) {
@@ -17,7 +17,9 @@ function printListDebug(result) {
 		["packages", result.debug.packageCount],
 		["skills", result.debug.skillCount],
 		["warnings", result.debug.warningCount],
-		["conflicts", result.debug.conflictCount]
+		["conflicts", result.debug.conflictCount],
+		["packageJsonReadCount", result.debug.scan.packageJsonReadCount],
+		["packageJsonCacheHits", result.debug.scan.packageJsonCacheHits]
 	]);
 }
 function printVersionConflicts(result) {
@@ -53,7 +55,7 @@ async function runListCommand(options, _scanIntentsOrFail) {
 		console.log(JSON.stringify(jsonResult, null, 2));
 		return;
 	}
-	const { computeSkillNameWidth, printSkillTree, printTable } = await import("./display-COlw5FaB.mjs");
+	const { computeSkillNameWidth, printSkillTree, printTable } = await import("./display-CmLzVAae.mjs");
 	if (result.packages.length === 0) {
 		console.log("No intent-enabled packages found.");
 		if (result.warnings.length > 0) {

package/dist/{load-8868G50-.mjs → load-DF-zIT3-.mjs}

@@ -1,12 +1,12 @@
-import "./utils-mdb4i6VA.mjs";
-import "./skill-paths-DNOHrvL5.mjs";
-import "./scanner-DwYsjXzI.mjs";
-import "./workspace-patterns-BZLEaMcS.mjs";
-import "./project-context-Dx6XIJJo.mjs";
-import "./resolver-CP0S8UjZ.mjs";
+import "./utils-BPDvfmcd.mjs";
+import "./skill-paths-BHbdWniB.mjs";
+import "./scanner-BGyQTQ3U.mjs";
+import "./workspace-patterns-CIJQCwbJ.mjs";
+import "./project-context-Bv9BDh8B.mjs";
+import "./resolver-BDsZ3kWg.mjs";
 import { t as fail } from "./cli-error-BrMXlbtx.mjs";
-import { a as printDebugInfo, n as coreOptionsFromGlobalFlags } from "./cli-support-BON5hn4L.mjs";
-import { i as resolveIntentSkill, r as loadIntentSkill, t as IntentCoreError } from "./core-baYs6H7Z.mjs";
+import { a as printDebugInfo, n as coreOptionsFromGlobalFlags } from "./cli-support-DtqVDiJv.mjs";
+import { i as resolveIntentSkill, r as loadIntentSkill, t as IntentCoreError } from "./core-BOSjgetf.mjs";
 
 //#region src/commands/load.ts
 function printLoadDebug(loaded) {
@@ -21,7 +21,9 @@ function printLoadDebug(loaded) {
 		["source", loaded.debug.source],
 		["skill", loaded.debug.skillName],
 		["path", loaded.debug.path],
-		["warnings", loaded.debug.warningCount]
+		["warnings", loaded.debug.warningCount],
+		["packageJsonReadCount", loaded.debug.scan.packageJsonReadCount],
+		["packageJsonCacheHits", loaded.debug.scan.packageJsonCacheHits]
 	]);
 }
 async function runLoadCommand(use, options, _scanIntentsOrFail) {

package/dist/{meta-CYV9EzM8.mjs → meta-BNSVXFQu.mjs}

@@ -16,7 +16,7 @@ async function runMetaCommand(name, metaDir) {
 		}
 		return;
 	}
-	const { parseFrontmatter } = await import("./utils-BHzSyNeJ.mjs");
+	const { parseFrontmatter } = await import("./utils-DqdIC3RY.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.");

package/dist/{project-context-Dx6XIJJo.mjs → project-context-Bv9BDh8B.mjs}

@@ -1,4 +1,4 @@
-import { a as readWorkspacePatterns, r as findWorkspaceRoot } from "./workspace-patterns-BZLEaMcS.mjs";
+import { a as readWorkspacePatterns, r as findWorkspaceRoot } from "./workspace-patterns-CIJQCwbJ.mjs";
 import { existsSync, statSync } from "node:fs";
 import { dirname, join, relative, resolve } from "node:path";
 

package/dist/{resolver-CP0S8UjZ.mjs → resolver-BDsZ3kWg.mjs}

@@ -1,5 +1,5 @@
 import { i as parseSkillUse } from "./skill-use-umYvZl94.mjs";
-import { t as resolveProjectContext } from "./project-context-Dx6XIJJo.mjs";
+import { t as resolveProjectContext } from "./project-context-Bv9BDh8B.mjs";
 import { readFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 
@@ -193,4 +193,4 @@ function formatSkillSuggestions(packageName, skillNames) {
 }
 
 //#endregion
-export { compileExcludePatterns as a, warningMentionsPackage as c, resolveSkillUse as i, readPackageJson as l, isResolveSkillUseError as n, getEffectiveExcludePatterns as o, resolveSkillEntry as r, isPackageExcluded as s, ResolveSkillUseError as t };
+export { compileExcludePatterns as a, warningMentionsPackage as c, resolveSkillUse as i, isResolveSkillUseError as n, getEffectiveExcludePatterns as o, resolveSkillEntry as r, isPackageExcluded as s, ResolveSkillUseError as t };

package/dist/{scanner-DwYsjXzI.mjs → scanner-BGyQTQ3U.mjs}

@@ -1,21 +1,41 @@
-import { a as parseFrontmatter, i as listNodeModulesPackageDirs, o as resolveDepDir, r as getDeps, s as toPosixPath, t as detectGlobalNodeModules } from "./utils-mdb4i6VA.mjs";
-import { r as rewriteSkillLoadPaths } from "./skill-paths-DNOHrvL5.mjs";
-import { a as readWorkspacePatterns, o as resolveWorkspacePackages, r as findWorkspaceRoot } from "./workspace-patterns-BZLEaMcS.mjs";
+import { a as parseFrontmatter, i as listNodeModulesPackageDirs, n as findSkillFiles, o as resolveDepDir, r as getDeps, s as toPosixPath, t as detectGlobalNodeModules } from "./utils-BPDvfmcd.mjs";
+import { r as rewriteSkillLoadPaths } from "./skill-paths-BHbdWniB.mjs";
+import { n as findWorkspacePackages, r as findWorkspaceRoot } from "./workspace-patterns-CIJQCwbJ.mjs";
 import { createRequire } from "node:module";
-import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import semver from "semver";
 
 //#region src/discovery/register.ts
 function isLocalToProject(dirPath, projectRoot) {
 	return dirPath.startsWith(projectRoot + sep) || dirPath.startsWith(projectRoot + "/");
 }
+function getFsIdentity(path) {
+	return resolve(path);
+}
 function createPackageRegistrar(opts) {
+	const attemptedPackageRoots = /* @__PURE__ */ new Set();
+	const scannedNodeModulesDirs = /* @__PURE__ */ new Set();
+	function shouldAttemptPackageRoot(dirPath) {
+		const key = getFsIdentity(dirPath);
+		if (attemptedPackageRoots.has(key)) return false;
+		attemptedPackageRoots.add(key);
+		return true;
+	}
+	function scanNodeModulesDir(nodeModulesDir, source = "local") {
+		if (!existsSync(nodeModulesDir)) return;
+		const key = getFsIdentity(nodeModulesDir);
+		if (scannedNodeModulesDirs.has(key)) return;
+		scannedNodeModulesDirs.add(key);
+		for (const dirPath of listNodeModulesPackageDirs(nodeModulesDir)) tryRegister(dirPath, "unknown", source);
+	}
 	function scanTarget(target, source = "local") {
 		if (!target.path || !target.exists || target.scanned) return;
 		target.scanned = true;
-		for (const dirPath of listNodeModulesPackageDirs(target.path)) tryRegister(dirPath, "unknown", source);
+		scanNodeModulesDir(target.path, source);
 	}
 	function tryRegister(dirPath, fallbackName, source = "local") {
+		if (!shouldAttemptPackageRoot(dirPath)) return false;
 		const skillsDir = join(dirPath, "skills");
 		if (!existsSync(skillsDir)) return false;
 		const pkgJson = opts.readPkgJson(dirPath);
@@ -61,6 +81,7 @@ function createPackageRegistrar(opts) {
 		return true;
 	}
 	return {
+		scanNodeModulesDir,
 		scanTarget,
 		tryRegister
 	};
@@ -107,19 +128,16 @@ function createDependencyWalker(opts) {
 		walkDepsOf(projectPkg, opts.projectRoot, true);
 	}
 	function readPkgJsonWithWarning(dirPath, label) {
-		try {
-			return JSON.parse(readFileSync(join(dirPath, "package.json"), "utf8"));
-		} catch (err) {
-			if (err.code !== "ENOENT") opts.warnings.push(`Could not read ${label} package.json at ${dirPath}: ${err.message}`);
+		const result = opts.fsCache.readPackageJsonResult(dirPath);
+		if (!result.packageJson) {
+			if (result.error?.code !== "ENOENT") opts.warnings.push(`Could not read ${label} package.json at ${dirPath}: ${result.error instanceof Error ? result.error.message : "invalid package.json"}`);
 			return null;
 		}
+		return result.packageJson;
 	}
 	function walkWorkspacePackages() {
-		const workspacePatterns = readWorkspacePatterns(opts.projectRoot);
-		if (!workspacePatterns) return;
-		for (const wsDir of resolveWorkspacePackages(opts.projectRoot, workspacePatterns)) {
-			const wsNodeModules = join(wsDir, "node_modules");
-			if (existsSync(wsNodeModules)) for (const dirPath of listNodeModulesPackageDirs(wsNodeModules)) opts.tryRegister(dirPath, "unknown");
+		for (const wsDir of findWorkspacePackages(opts.projectRoot)) {
+			opts.scanNodeModulesDir(join(wsDir, "node_modules"));
 			const wsPkg = readPkgJsonWithWarning(wsDir, "workspace");
 			if (wsPkg) walkDepsOf(wsPkg, wsDir);
 		}
@@ -131,6 +149,65 @@ function createDependencyWalker(opts) {
 	};
 }
 
+//#endregion
+//#region src/fs-cache.ts
+function normalizeCacheKey(path) {
+	return resolve(path);
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function createIntentFsCache() {
+	const packageJsonCache = /* @__PURE__ */ new Map();
+	const skillFilesCache = /* @__PURE__ */ new Map();
+	const stats = {
+		packageJsonReadCount: 0,
+		packageJsonCacheHits: 0
+	};
+	function readPackageJsonResult(dir) {
+		const key = normalizeCacheKey(dir);
+		const cached = packageJsonCache.get(key);
+		if (cached) {
+			stats.packageJsonCacheHits += 1;
+			return cached;
+		}
+		stats.packageJsonReadCount += 1;
+		try {
+			const parsed = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
+			const result = {
+				packageJson: isRecord(parsed) ? parsed : null,
+				error: null
+			};
+			packageJsonCache.set(key, result);
+			return result;
+		} catch (error) {
+			const result = {
+				packageJson: null,
+				error
+			};
+			packageJsonCache.set(key, result);
+			return result;
+		}
+	}
+	function readPackageJson(dir) {
+		return readPackageJsonResult(dir).packageJson;
+	}
+	function findSkillFiles$1(dir) {
+		const key = normalizeCacheKey(dir);
+		const cached = skillFilesCache.get(key);
+		if (cached) return [...cached];
+		const files = findSkillFiles(dir);
+		skillFilesCache.set(key, files);
+		return [...files];
+	}
+	return {
+		readPackageJson,
+		readPackageJsonResult,
+		findSkillFiles: findSkillFiles$1,
+		getStats: () => ({ ...stats })
+	};
+}
+
 //#endregion
 //#region src/scanner.ts
 const requireFromHere = createRequire(import.meta.url);
@@ -260,28 +337,12 @@ function discoverSkillByNameHint(skillsDir, packageName, skillNameHint) {
 	}
 	return skills;
 }
-function discoverSkills(skillsDir) {
-	const skills = [];
-	function walk(dir) {
-		let entries;
-		try {
-			entries = readdirSync(dir, {
-				withFileTypes: true,
-				encoding: "utf8"
-			});
-		} catch {
-			return;
-		}
-		for (const entry of entries) {
-			if (!entry.isDirectory()) continue;
-			const childDir = join(dir, entry.name);
-			const skillFile = join(childDir, "SKILL.md");
-			if (existsSync(skillFile)) skills.push(readSkillEntry(skillsDir, childDir, skillFile));
-			walk(childDir);
-		}
-	}
-	walk(skillsDir);
-	return skills;
+function discoverSkills(skillsDir, fsCache) {
+	return fsCache.findSkillFiles(skillsDir).flatMap((skillFile) => {
+		const childDir = dirname(skillFile);
+		if (childDir === skillsDir) return [];
+		return [readSkillEntry(skillsDir, childDir, skillFile)];
+	});
 }
 function getPackageShortName(packageName) {
 	return packageName.split("/").pop() ?? packageName;
@@ -325,49 +386,20 @@ function topoSort(packages) {
 function getPackageDepth(packageRoot, projectRoot) {
 	return relative(projectRoot, packageRoot).split(sep).length;
 }
-function parseSemver(version) {
-	const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(version);
-	if (!match) return null;
-	const prerelease = match[4] ? match[4].split(".").map((identifier) => {
-		return /^\d+$/.test(identifier) ? Number(identifier) : identifier;
-	}) : [];
-	return {
-		major: Number(match[1]),
-		minor: Number(match[2]),
-		patch: Number(match[3]),
-		prerelease
-	};
-}
-function comparePrereleaseIdentifiers(a, b) {
-	if (a === void 0) return b === void 0 ? 0 : 1;
-	if (b === void 0) return -1;
-	if (typeof a === "number" && typeof b === "number") return a - b;
-	if (typeof a === "number") return -1;
-	if (typeof b === "number") return 1;
-	return a.localeCompare(b);
+function normalizeVersion(version) {
+	const validVersion = semver.valid(version);
+	if (validVersion) return validVersion;
+	return semver.coerce(version)?.version ?? null;
 }
 function comparePackageVersions(a, b) {
-	const parsedA = parseSemver(a);
-	const parsedB = parseSemver(b);
-	if (!parsedA || !parsedB) {
-		if (parsedA) return 1;
-		if (parsedB) return -1;
+	const versionA = normalizeVersion(a);
+	const versionB = normalizeVersion(b);
+	if (!versionA || !versionB) {
+		if (versionA) return 1;
+		if (versionB) return -1;
 		return 0;
 	}
-	for (const key of [
-		"major",
-		"minor",
-		"patch"
-	]) {
-		const diff = parsedA[key] - parsedB[key];
-		if (diff !== 0) return diff;
-	}
-	const length = Math.max(parsedA.prerelease.length, parsedB.prerelease.length);
-	for (let i = 0; i < length; i++) {
-		const diff = comparePrereleaseIdentifiers(parsedA.prerelease[i], parsedB.prerelease[i]);
-		if (diff !== 0) return diff;
-	}
-	return 0;
+	return semver.compare(versionA, versionB);
 }
 function formatVariantWarning(name, variants, chosen) {
 	const uniqueVersions = new Set(variants.map((variant) => variant.version));
@@ -392,6 +424,7 @@ function getScanScope(options) {
 function scanForIntents(root, options = {}) {
 	const projectRoot = root ?? process.cwd();
 	const scanScope = getScanScope(options);
+	const fsCache = options.fsCache ?? createIntentFsCache();
 	const packageManager = detectPackageManager(projectRoot);
 	const nodeModulesDir = join(projectRoot, "node_modules");
 	const explicitGlobalNodeModules = process.env.INTENT_GLOBAL_NODE_MODULES?.trim() || null;
@@ -414,7 +447,6 @@ function scanForIntents(root, options = {}) {
 		}
 	};
 	const packageIndexes = /* @__PURE__ */ new Map();
-	const packageJsonCache = /* @__PURE__ */ new Map();
 	const packageVariants = /* @__PURE__ */ new Map();
 	let pnpApi;
 	function getPnpApi() {
@@ -422,6 +454,9 @@ function scanForIntents(root, options = {}) {
 		if (pnpApi === void 0) pnpApi = loadPnpApi(projectRoot);
 		return pnpApi;
 	}
+	function getStats() {
+		return fsCache.getStats();
+	}
 	function rememberVariant(pkg) {
 		let variants = packageVariants.get(pkg.name);
 		if (!variants) {
@@ -443,20 +478,12 @@ function scanForIntents(root, options = {}) {
 		}
 	}
 	function readPkgJson(dirPath) {
-		if (packageJsonCache.has(dirPath)) return packageJsonCache.get(dirPath) ?? null;
-		try {
-			const pkgJson = JSON.parse(readFileSync(join(dirPath, "package.json"), "utf8"));
-			packageJsonCache.set(dirPath, pkgJson);
-			return pkgJson;
-		} catch {
-			packageJsonCache.set(dirPath, null);
-			return null;
-		}
+		return fsCache.readPackageJson(dirPath);
 	}
-	const { scanTarget, tryRegister } = createPackageRegistrar({
+	const { scanNodeModulesDir, scanTarget, tryRegister } = createPackageRegistrar({
 		comparePackageVersions,
 		deriveIntentConfig,
-		discoverSkills,
+		discoverSkills: (skillsDir) => discoverSkills(skillsDir, fsCache),
 		getPackageDepth,
 		packageIndexes,
 		packages,
@@ -467,9 +494,11 @@ function scanForIntents(root, options = {}) {
 		warnings
 	});
 	const { walkKnownPackages, walkProjectDeps, walkWorkspacePackages } = createDependencyWalker({
+		fsCache,
 		packages,
 		projectRoot,
 		readPkgJson,
+		scanNodeModulesDir,
 		tryRegister,
 		warnings
 	});
@@ -534,7 +563,8 @@ function scanForIntents(root, options = {}) {
 		packages,
 		warnings,
 		conflicts,
-		nodeModules
+		nodeModules,
+		stats: getStats()
 	};
 	for (const pkg of packages) {
 		const variants = packageVariants.get(pkg.name);
@@ -549,7 +579,8 @@ function scanForIntents(root, options = {}) {
 		packages: topoSort(packages),
 		warnings,
 		conflicts,
-		nodeModules
+		nodeModules,
+		stats: getStats()
 	};
 }
 function scanIntentPackageAtRoot(packageRoot, options = {}) {
@@ -557,22 +588,14 @@ function scanIntentPackageAtRoot(packageRoot, options = {}) {
 	const packages = [];
 	const warnings = [];
 	const packageIndexes = /* @__PURE__ */ new Map();
-	const packageJsonCache = /* @__PURE__ */ new Map();
+	const fsCache = options.fsCache ?? createIntentFsCache();
 	function readPkgJson(dirPath) {
-		if (packageJsonCache.has(dirPath)) return packageJsonCache.get(dirPath) ?? null;
-		try {
-			const pkgJson = JSON.parse(readFileSync(join(dirPath, "package.json"), "utf8"));
-			packageJsonCache.set(dirPath, pkgJson);
-			return pkgJson;
-		} catch {
-			packageJsonCache.set(dirPath, null);
-			return null;
-		}
+		return fsCache.readPackageJson(dirPath);
 	}
 	const { tryRegister } = createPackageRegistrar({
 		comparePackageVersions,
 		deriveIntentConfig,
-		discoverSkills: options.skillNameHint ? (skillsDir, packageName) => discoverSkillByNameHint(skillsDir, packageName, options.skillNameHint) : discoverSkills,
+		discoverSkills: options.skillNameHint ? (skillsDir, packageName) => discoverSkillByNameHint(skillsDir, packageName, options.skillNameHint) : (skillsDir) => discoverSkills(skillsDir, fsCache),
 		getPackageDepth,
 		packageIndexes,
 		packages,
@@ -590,4 +613,4 @@ function scanIntentPackageAtRoot(packageRoot, options = {}) {
 }
 
 //#endregion
-export { scanIntentPackageAtRoot as n, scanForIntents as t };
+export { scanIntentPackageAtRoot as n, createIntentFsCache as r, scanForIntents as t };

package/dist/scanner-Ix6MmxfB.mjs

@@ -0,0 +1,6 @@
+import "./utils-BPDvfmcd.mjs";
+import "./skill-paths-BHbdWniB.mjs";
+import { n as scanIntentPackageAtRoot, t as scanForIntents } from "./scanner-BGyQTQ3U.mjs";
+import "./workspace-patterns-CIJQCwbJ.mjs";
+
+export { scanForIntents };

package/dist/{setup-kvWN4xCr.mjs → setup-DQMKxEoA.mjs}

@@ -1,5 +1,5 @@
-import { a as readWorkspacePatterns, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-BZLEaMcS.mjs";
-import { t as resolveProjectContext } from "./project-context-Dx6XIJJo.mjs";
+import { a as readWorkspacePatterns, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-CIJQCwbJ.mjs";
+import { t as resolveProjectContext } from "./project-context-Bv9BDh8B.mjs";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { basename, join, relative } from "node:path";
 

package/dist/setup.mjs

@@ -1,6 +1,6 @@
-import "./utils-mdb4i6VA.mjs";
-import { a as readWorkspacePatterns, o as resolveWorkspacePackages, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-BZLEaMcS.mjs";
-import "./project-context-Dx6XIJJo.mjs";
-import { n as runEditPackageJsonAll, r as runSetupGithubActions, t as runEditPackageJson } from "./setup-kvWN4xCr.mjs";
+import "./utils-BPDvfmcd.mjs";
+import { a as readWorkspacePatterns, o as resolveWorkspacePackages, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-CIJQCwbJ.mjs";
+import "./project-context-Bv9BDh8B.mjs";
+import { n as runEditPackageJsonAll, r as runSetupGithubActions, t as runEditPackageJson } from "./setup-DQMKxEoA.mjs";
 
 export { findPackagesWithSkills, findWorkspaceRoot, readWorkspacePatterns, resolveWorkspacePackages, runEditPackageJson, runEditPackageJsonAll, runSetupGithubActions };

package/dist/{skill-paths-DNOHrvL5.mjs → skill-paths-BHbdWniB.mjs}

@@ -1,4 +1,4 @@
-import { s as toPosixPath } from "./utils-mdb4i6VA.mjs";
+import { s as toPosixPath } from "./utils-BPDvfmcd.mjs";
 import { existsSync } from "node:fs";
 import { join, relative } from "node:path";
 

package/dist/{staleness-CFr3W-RI.mjs → staleness-CGLs-swr.mjs}

@@ -1,17 +1,34 @@
-import { a as parseFrontmatter, n as findSkillFiles } from "./utils-mdb4i6VA.mjs";
+import { a as parseFrontmatter, n as findSkillFiles, s as toPosixPath } from "./utils-BPDvfmcd.mjs";
 import { t as readIntentArtifacts } from "./artifact-coverage-DgWuVqUp.mjs";
 import { existsSync, readFileSync } from "node:fs";
-import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import { isAbsolute, join, relative, resolve } from "node:path";
+import semver from "semver";
 
 //#region src/staleness.ts
 function classifyVersionDrift(oldVer, newVer) {
-	if (oldVer === newVer) return null;
-	const oldParts = oldVer.replace(/[^0-9.]/g, "").split(".").map(Number);
-	const newParts = newVer.replace(/[^0-9.]/g, "").split(".").map(Number);
-	if ((newParts[0] ?? 0) > (oldParts[0] ?? 0)) return "major";
-	if ((newParts[1] ?? 0) > (oldParts[1] ?? 0)) return "minor";
-	if ((newParts[2] ?? 0) > (oldParts[2] ?? 0)) return "patch";
-	return null;
+	const oldVersion = normalizeVersion(oldVer);
+	const newVersion = normalizeVersion(newVer);
+	if (!oldVersion || !newVersion) return null;
+	if (semver.eq(oldVersion, newVersion)) return null;
+	if (!semver.gt(newVersion, oldVersion)) return null;
+	const oldParsed = semver.parse(oldVersion);
+	const newParsed = semver.parse(newVersion);
+	if (oldParsed && newParsed && oldParsed.major === newParsed.major && oldParsed.minor === newParsed.minor && oldParsed.patch === newParsed.patch && oldParsed.prerelease.length > 0) return "patch";
+	switch (semver.diff(oldVersion, newVersion)) {
+		case "major":
+		case "premajor": return "major";
+		case "minor":
+		case "preminor": return "minor";
+		case "patch":
+		case "prepatch":
+		case "prerelease": return "patch";
+		default: return null;
+	}
+}
+function normalizeVersion(version) {
+	const validVersion = semver.valid(version);
+	if (validVersion) return validVersion;
+	return semver.coerce(version)?.version ?? null;
 }
 function readLocalVersion(packageDir) {
 	try {
@@ -75,7 +92,10 @@ function readPackageJson(packageDir) {
 	}
 }
 function normalizeFilePath(path) {
-	return resolve(path).split(sep).join("/");
+	return toPosixPath(resolve(path));
+}
+function getRelativePackageDir(artifactRoot, packageDir) {
+	return toPosixPath(relative(artifactRoot, packageDir));
 }
 function normalizeList(values) {
 	return [...new Set(values ?? [])].sort((a, b) => a.localeCompare(b));
@@ -86,7 +106,7 @@ function sameStringList(a, b) {
 	return left.length === right.length && left.every((value, index) => value === right[index]);
 }
 function artifactPackageMatches(artifact, packageDir, packageName, artifactRoot) {
-	const relPackageDir = relative(artifactRoot, packageDir).split(sep).join("/");
+	const relPackageDir = getRelativePackageDir(artifactRoot, packageDir);
 	if (!relPackageDir) return true;
 	if (artifact.packages.includes(packageName)) return true;
 	if (artifact.packages.includes(relPackageDir)) return true;
@@ -163,11 +183,11 @@ function buildArtifactSignals({ artifactRoot, artifacts, library, packageDir, sk
 	return signals;
 }
 function artifactCoversPackage(artifact, packageDir, packageName, artifactRoot) {
-	const relPackageDir = relative(artifactRoot, packageDir).split(sep).join("/");
+	const relPackageDir = getRelativePackageDir(artifactRoot, packageDir);
 	return artifact.packages.includes(packageName) || artifact.packages.includes(relPackageDir) || artifact.package === packageName || artifact.package === relPackageDir || artifact.path?.startsWith(`${relPackageDir}/`) === true;
 }
 function artifactIgnoresPackage(artifacts, packageDir, packageName, artifactRoot) {
-	const relPackageDir = relative(artifactRoot, packageDir).split(sep).join("/");
+	const relPackageDir = getRelativePackageDir(artifactRoot, packageDir);
 	return artifacts.ignoredPackages.some((ignored) => ignored.packageName === packageName || ignored.packageName === relPackageDir);
 }
 function buildWorkspaceCoverageSignals({ artifactRoot, artifacts, packageDirs }) {
@@ -187,17 +207,17 @@ function buildWorkspaceCoverageSignals({ artifactRoot, artifacts, packageDirs })
 			reasons: ["workspace package is not represented by generated skills or _artifacts coverage"],
 			needsReview: true,
 			packageName,
-			packageRoot: relative(artifactRoot, packageDir).split(sep).join("/")
+			packageRoot: getRelativePackageDir(artifactRoot, packageDir)
 		});
 	}
 	return signals;
 }
 async function checkStaleness(packageDir, packageName, artifactRoot = packageDir) {
 	const skillsDir = join(packageDir, "skills");
-	const library = packageName ?? "unknown";
+	const library = packageName ?? readPackageName(packageDir);
 	const skillMetas = findSkillFiles(skillsDir).map((filePath) => {
 		const fm = parseFrontmatter(filePath);
-		const relName = relative(skillsDir, filePath).replace(/[/\\]SKILL\.md$/, "").split(sep).join("/");
+		const relName = toPosixPath(relative(skillsDir, filePath)).replace(/[/\\]SKILL\.md$/, "");
 		return {
 			name: typeof fm?.name === "string" ? fm.name : relName,
 			relName,
@@ -218,7 +238,7 @@ async function checkStaleness(packageDir, packageName, artifactRoot = packageDir
 		versionDrift,
 		skills: skillMetas.map((skill) => {
 			const reasons = [];
-			if (currentVersion && skill.libraryVersion && skill.libraryVersion !== currentVersion) reasons.push(`version drift (${skill.libraryVersion} → ${currentVersion})`);
+			if (currentVersion && skill.libraryVersion && classifyVersionDrift(skill.libraryVersion, currentVersion) !== null) reasons.push(`version drift (${skill.libraryVersion} → ${currentVersion})`);
 			const storedShas = syncState?.skills?.[skill.name]?.sources_sha ?? {};
 			if (skill.sources && Object.keys(storedShas).length > 0) {
 				for (const source of skill.sources) if (!storedShas[source]) reasons.push(`new source (${source})`);

package/dist/{staleness-DpyuNdd5.mjs → staleness-Dl-m8JWM.mjs}

@@ -1,5 +1,5 @@
-import "./utils-mdb4i6VA.mjs";
+import "./utils-BPDvfmcd.mjs";
 import "./artifact-coverage-DgWuVqUp.mjs";
-import { n as checkStaleness, r as readPackageName, t as buildWorkspaceCoverageSignals } from "./staleness-CFr3W-RI.mjs";
+import { n as checkStaleness, r as readPackageName, t as buildWorkspaceCoverageSignals } from "./staleness-CGLs-swr.mjs";
 
 export { buildWorkspaceCoverageSignals, checkStaleness, readPackageName };

package/dist/{types-S2zpibHp.d.mts → types-Cq5cY9h9.d.mts}

@@ -14,12 +14,17 @@ interface ScanResult {
     local: NodeModulesScanTarget;
     global: NodeModulesScanTarget;
   };
+  stats?: ScanStats;
 }
 type ScanScope = 'local' | 'local-and-global' | 'global';
 interface ScanOptions {
   includeGlobal?: boolean;
   scope?: ScanScope;
 }
+interface ScanStats {
+  packageJsonReadCount: number;
+  packageJsonCacheHits: number;
+}
 interface NodeModulesScanTarget {
   path: string | null;
   detected: boolean;
@@ -143,4 +148,4 @@ interface IntentProjectConfig {
   };
 }
 //#endregion
-export { SkillStaleness as _, IntentArtifactSet as a, VersionConflict as b, IntentConfig as c, MetaFeedbackPayload as d, MetaSkillName as f, SkillEntry as g, ScanScope as h, IntentArtifactFile as i, IntentPackage as l, ScanResult as m, FeedbackPayload as n, IntentArtifactSkill as o, ScanOptions as p, IntentArtifactCoverageIgnore as r, IntentArtifactWarning as s, AgentName as t, IntentProjectConfig as u, StalenessReport as v, StalenessSignal as y };
+export { SkillEntry as _, IntentArtifactSet as a, StalenessSignal as b, IntentConfig as c, MetaFeedbackPayload as d, MetaSkillName as f, ScanStats as g, ScanScope as h, IntentArtifactFile as i, IntentPackage as l, ScanResult as m, FeedbackPayload as n, IntentArtifactSkill as o, ScanOptions as p, IntentArtifactCoverageIgnore as r, IntentArtifactWarning as s, AgentName as t, IntentProjectConfig as u, SkillStaleness as v, VersionConflict as x, StalenessReport as y };

package/dist/{utils-mdb4i6VA.mjs → utils-BPDvfmcd.mjs}

@@ -17,7 +17,16 @@ function toPosixPath(p) {
 function findSkillFiles(dir) {
 	const files = [];
 	if (!existsSync(dir)) return files;
-	for (const entry of readdirSync(dir, { withFileTypes: true })) {
+	let entries;
+	try {
+		entries = readdirSync(dir, {
+			withFileTypes: true,
+			encoding: "utf8"
+		});
+	} catch {
+		return files;
+	}
+	for (const entry of entries) {
 		const fullPath = join(dir, entry.name);
 		if (entry.isDirectory()) files.push(...findSkillFiles(fullPath));
 		else if (entry.name === "SKILL.md") files.push(fullPath);

package/dist/{utils-BHzSyNeJ.mjs → utils-DqdIC3RY.mjs}

@@ -1,3 +1,3 @@
-import { a as parseFrontmatter, i as listNodeModulesPackageDirs, n as findSkillFiles, o as resolveDepDir, r as getDeps, s as toPosixPath, t as detectGlobalNodeModules } from "./utils-mdb4i6VA.mjs";
+import { a as parseFrontmatter, i as listNodeModulesPackageDirs, n as findSkillFiles, o as resolveDepDir, r as getDeps, s as toPosixPath, t as detectGlobalNodeModules } from "./utils-BPDvfmcd.mjs";
 
 export { detectGlobalNodeModules, findSkillFiles, getDeps, listNodeModulesPackageDirs, parseFrontmatter, resolveDepDir, toPosixPath };

package/dist/{validate-BL1SYAwh.mjs → validate-Divq4AiV.mjs}

@@ -1,8 +1,8 @@
-import "./utils-mdb4i6VA.mjs";
-import { n as findWorkspacePackages } from "./workspace-patterns-BZLEaMcS.mjs";
-import { t as resolveProjectContext } from "./project-context-Dx6XIJJo.mjs";
+import "./utils-BPDvfmcd.mjs";
+import { n as findWorkspacePackages } from "./workspace-patterns-CIJQCwbJ.mjs";
+import { t as resolveProjectContext } from "./project-context-Bv9BDh8B.mjs";
 import { n as isCliFailure, t as fail } from "./cli-error-BrMXlbtx.mjs";
-import { l as printWarnings } from "./cli-support-BON5hn4L.mjs";
+import { l as printWarnings } from "./cli-support-DtqVDiJv.mjs";
 import { appendFileSync, existsSync, readFileSync } from "node:fs";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";
 
@@ -115,7 +115,7 @@ async function runValidateCommand(dir, options = {}) {
 	}
 }
 async function runValidateCommandInternal(dir) {
-	const [{ parse: parseYaml }, { findSkillFiles }] = await Promise.all([import("yaml"), import("./utils-BHzSyNeJ.mjs")]);
+	const [{ parse: parseYaml }, { findSkillFiles }] = await Promise.all([import("yaml"), import("./utils-DqdIC3RY.mjs")]);
 	const context = resolveProjectContext({
 		cwd: process.cwd(),
 		targetPath: dir

package/dist/{workspace-patterns-BZLEaMcS.mjs → workspace-patterns-CIJQCwbJ.mjs}

@@ -1,4 +1,4 @@
-import { n as findSkillFiles } from "./utils-mdb4i6VA.mjs";
+import { n as findSkillFiles } from "./utils-BPDvfmcd.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { parse } from "yaml";

package/dist/{workspace-patterns-BWMz7TsI.mjs → workspace-patterns-Diy5gtz_.mjs}

@@ -1,4 +1,4 @@
-import "./utils-mdb4i6VA.mjs";
-import { a as readWorkspacePatterns, i as getWorkspaceInfo, n as findWorkspacePackages, o as resolveWorkspacePackages, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-BZLEaMcS.mjs";
+import "./utils-BPDvfmcd.mjs";
+import { a as readWorkspacePatterns, i as getWorkspaceInfo, n as findWorkspacePackages, o as resolveWorkspacePackages, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-CIJQCwbJ.mjs";
 
 export { findWorkspaceRoot, getWorkspaceInfo };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/intent",
-  "version": "0.0.38",
+  "version": "0.0.40",
   "description": "Ship compositional knowledge for AI coding agents alongside your npm packages",
   "license": "MIT",
   "type": "module",
@@ -33,9 +33,11 @@
   "dependencies": {
     "cac": "^6.7.14",
     "jsonc-parser": "^3.3.1",
+    "semver": "^7.7.4",
     "yaml": "2.8.3"
   },
   "devDependencies": {
+    "@types/semver": "^7.7.1",
     "@verdaccio/node-api": "6.0.0-6-next.76",
     "tsdown": "^0.19.0",
     "verdaccio": "^6.3.2"

package/dist/display-COlw5FaB.mjs

@@ -1,5 +0,0 @@
-import "./utils-mdb4i6VA.mjs";
-import "./skill-paths-DNOHrvL5.mjs";
-import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-CVeoAwBd.mjs";
-
-export { computeSkillNameWidth, printSkillTree, printTable };

package/dist/install-RZpz279M.mjs

@@ -1,7 +0,0 @@
-import "./utils-mdb4i6VA.mjs";
-import "./workspace-patterns-BZLEaMcS.mjs";
-import "./project-context-Dx6XIJJo.mjs";
-import "./cli-support-BON5hn4L.mjs";
-import { n as runInstallCommand, t as INSTALL_PROMPT } from "./install-BPWtaOuo.mjs";
-
-export { INSTALL_PROMPT, runInstallCommand };

package/dist/scanner-ByG70-E3.mjs

@@ -1,6 +0,0 @@
-import "./utils-mdb4i6VA.mjs";
-import "./skill-paths-DNOHrvL5.mjs";
-import { n as scanIntentPackageAtRoot, t as scanForIntents } from "./scanner-DwYsjXzI.mjs";
-import "./workspace-patterns-BZLEaMcS.mjs";
-
-export { scanForIntents };