@tanstack/intent 0.0.40 → 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-DtqVDiJv.mjs → cli-support-BHoEb9y1.mjs}

@@ -1,5 +1,5 @@
-import { t as resolveProjectContext } from "./project-context-Bv9BDh8B.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-Ix6MmxfB.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-Dl-m8JWM.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-Diy5gtz_.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-Cb9lNXhL.mjs → cli-support-BxF1HIpw.mjs}

@@ -1,6 +1,6 @@
-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";
+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-CxSm8YYl.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-DF-zIT3-.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-Cb9lNXhL.mjs"), import("./meta-BNSVXFQu.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-Divq4AiV.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-Cb9lNXhL.mjs"), import("./install-ChddjnhO.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-Cb9lNXhL.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-Cb9lNXhL.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-Cb9lNXhL.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-Cb9lNXhL.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-BOSjgetf.mjs → core-DEiRgUqe.mjs}

@@ -1,9 +1,9 @@
-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-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 { 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";
 
@@ -365,20 +365,22 @@ function listIntentSkills(options = {}) {
 	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,

package/dist/core.d.mts

@@ -1,4 +1,4 @@
-import { g as ScanStats, h as ScanScope, l as IntentPackage, x as VersionConflict } from "./types-Cq5cY9h9.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>;

package/dist/core.mjs

@@ -1,9 +1,9 @@
-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";
+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-DHNuzSqR.mjs → display-BPM-AJGc.mjs}

@@ -1,4 +1,4 @@
-import { n as isStableLoadPath, t as formatRuntimeSkillLookupHint } from "./skill-paths-BHbdWniB.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 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";
+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-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-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-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 { 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-CLkmoPOY.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-DtqVDiJv.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-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";
+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-BAJ7bXtW.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-BPDvfmcd.mjs";
-import { r as rewriteSkillLoadPaths } from "./skill-paths-BHbdWniB.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 { _ as SkillEntry } from "./types-Cq5cY9h9.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-BPDvfmcd.mjs";
-import "./skill-paths-BHbdWniB.mjs";
-import { t as scanLibrary } from "./library-scanner-BAJ7bXtW.mjs";
+import "./utils-Chn-30vI.mjs";
+import "./skill-paths-4kQXfQXo.mjs";
+import { t as scanLibrary } from "./library-scanner-BpEuR__1.mjs";
 
 export { scanLibrary };

package/dist/{list-CxSm8YYl.mjs → list-CpOcnLWv.mjs}

@@ -1,11 +1,12 @@
-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";
+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 { t as formatIntentCommand } from "./command-runner-DJTliSTc.mjs";
+import { a as printDebugInfo, l as printWarnings, n as coreOptionsFromGlobalFlags } from "./cli-support-BHoEb9y1.mjs";
+import { n as listIntentSkills } from "./core-DEiRgUqe.mjs";
 
 //#region src/commands/list.ts
 function printListDebug(result) {
@@ -47,15 +48,18 @@ function groupSkillsByPackageRoot(skills) {
 function getPackageSkills(pkg, skillsByPackageRoot) {
 	return skillsByPackageRoot.get(pkg.packageRoot) ?? [];
 }
+function formatLoadCommand(skill, packageManager, scopeFlag) {
+	return formatIntentCommand(packageManager, `load ${skill.use}${scopeFlag}`);
+}
 async function runListCommand(options, _scanIntentsOrFail) {
 	const result = listIntentSkills(coreOptionsFromGlobalFlags(options));
 	printListDebug(result);
 	if (options.json) {
-		const { debug: _debug, ...jsonResult } = result;
+		const { debug: _debug, packageManager: _packageManager, ...jsonResult } = result;
 		console.log(JSON.stringify(jsonResult, null, 2));
 		return;
 	}
-	const { computeSkillNameWidth, printSkillTree, printTable } = await import("./display-CmLzVAae.mjs");
+	const { computeSkillNameWidth, printSkillTree, printTable } = await import("./display-lWCJg5Bo.mjs");
 	if (result.packages.length === 0) {
 		console.log("No intent-enabled packages found.");
 		if (result.warnings.length > 0) {
@@ -84,12 +88,14 @@ async function runListCommand(options, _scanIntentsOrFail) {
 		type: skill.type
 	}))));
 	const showTypes = result.skills.some((skill) => skill.type);
+	const scopeFlag = options.globalOnly ? " --global-only" : options.global ? " --global" : "";
 	console.log(`\nSkills:\n`);
 	for (const pkg of result.packages) {
 		console.log(`  ${pkg.name}`);
 		printSkillTree(getPackageSkills(pkg, skillsByPackageRoot).map((skill) => ({
 			name: skill.skillName,
 			description: skill.description,
+			loadCommand: formatLoadCommand(skill, result.packageManager, scopeFlag),
 			type: skill.type
 		})), {
 			nameWidth,

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

@@ -1,12 +1,12 @@
-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-DtqVDiJv.mjs";
-import { i as resolveIntentSkill, r as loadIntentSkill, t as IntentCoreError } from "./core-BOSjgetf.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 { t as fail } from "./cli-error-DOO5bLIG.mjs";
+import { a as printDebugInfo, n as coreOptionsFromGlobalFlags } from "./cli-support-BHoEb9y1.mjs";
+import { i as resolveIntentSkill, r as loadIntentSkill, t as IntentCoreError } from "./core-DEiRgUqe.mjs";
 
 //#region src/commands/load.ts
 function printLoadDebug(loaded) {

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

@@ -1,4 +1,4 @@
-import { t as fail } from "./cli-error-BrMXlbtx.mjs";
+import { t as fail } from "./cli-error-DOO5bLIG.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join } from "node:path";
 
@@ -16,7 +16,7 @@ async function runMetaCommand(name, metaDir) {
 		}
 		return;
 	}
-	const { parseFrontmatter } = await import("./utils-DqdIC3RY.mjs");
+	const { parseFrontmatter } = await import("./utils-Ctlz_JG-.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/package-manager-DDZck142.mjs

@@ -0,0 +1,48 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+
+//#region src/package-manager.ts
+function readPackageManagerField(dir) {
+	try {
+		const parsed = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
+		if (!parsed || typeof parsed !== "object") return null;
+		const value = parsed.packageManager;
+		if (typeof value !== "string") return null;
+		if (value.startsWith("pnpm@")) return "pnpm";
+		if (value.startsWith("yarn@")) return "yarn";
+		if (value.startsWith("bun@")) return "bun";
+		if (value.startsWith("npm@")) return "npm";
+	} catch {
+		return null;
+	}
+	return null;
+}
+function detectPackageManagerInDir(dir) {
+	const packageManager = readPackageManagerField(dir);
+	if (packageManager) return packageManager;
+	if (existsSync(join(dir, ".pnp.cjs")) || existsSync(join(dir, ".pnp.js"))) return "yarn";
+	if (existsSync(join(dir, "pnpm-lock.yaml"))) return "pnpm";
+	if (existsSync(join(dir, "bun.lockb")) || existsSync(join(dir, "bun.lock"))) return "bun";
+	if (existsSync(join(dir, "yarn.lock"))) return "yarn";
+	if (existsSync(join(dir, "package-lock.json"))) return "npm";
+	return null;
+}
+function detectPackageManager(cwd = process.cwd(), extraDirs = []) {
+	const seen = /* @__PURE__ */ new Set();
+	const startDirs = [cwd, ...extraDirs].filter((dir) => Boolean(dir));
+	for (const startDir of startDirs) {
+		let dir = resolve(startDir);
+		while (!seen.has(dir)) {
+			seen.add(dir);
+			const packageManager = detectPackageManagerInDir(dir);
+			if (packageManager) return packageManager;
+			const next = dirname(dir);
+			if (next === dir) break;
+			dir = next;
+		}
+	}
+	return "unknown";
+}
+
+//#endregion
+export { detectPackageManager as t };

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

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

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

@@ -1,5 +1,5 @@
-import { i as parseSkillUse } from "./skill-use-umYvZl94.mjs";
-import { t as resolveProjectContext } from "./project-context-Bv9BDh8B.mjs";
+import { i as parseSkillUse } from "./skill-use-C0q2MEEX.mjs";
+import { t as resolveProjectContext } from "./project-context-D4mFnCs7.mjs";
 import { readFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 

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

@@ -1,6 +1,7 @@
-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 { a as listNestedNodeModulesPackageDirs, c as resolveDepDir, i as getDeps, l as toPosixPath, n as detectGlobalNodeModules, o as listNodeModulesPackageDirs, r as findSkillFiles, s as parseFrontmatter, t as createFsIdentityCache } from "./utils-Chn-30vI.mjs";
+import { r as rewriteSkillLoadPaths } from "./skill-paths-4kQXfQXo.mjs";
+import { n as findWorkspacePackages, r as findWorkspaceRoot } from "./workspace-patterns-C5O4Dfpl.mjs";
+import { t as detectPackageManager } from "./package-manager-DDZck142.mjs";
 import { createRequire } from "node:module";
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
@@ -10,21 +11,18 @@ import semver from "semver";
 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);
+		const key = opts.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);
+		const key = opts.getFsIdentity(nodeModulesDir);
 		if (scannedNodeModulesDirs.has(key)) return;
 		scannedNodeModulesDirs.add(key);
 		for (const dirPath of listNodeModulesPackageDirs(nodeModulesDir)) tryRegister(dirPath, "unknown", source);
@@ -93,10 +91,11 @@ function createDependencyWalker(opts) {
 	const walkVisited = /* @__PURE__ */ new Set();
 	const depDirCache = /* @__PURE__ */ new Map();
 	function resolveDepDirCached(depName, fromDir) {
-		let byDepName = depDirCache.get(fromDir);
+		const fromKey = opts.getFsIdentity(fromDir);
+		let byDepName = depDirCache.get(fromKey);
 		if (!byDepName) {
 			byDepName = /* @__PURE__ */ new Map();
-			depDirCache.set(fromDir, byDepName);
+			depDirCache.set(fromKey, byDepName);
 		}
 		if (!byDepName.has(depName)) byDepName.set(depName, resolveDepDir(depName, fromDir));
 		return byDepName.get(depName) ?? null;
@@ -104,14 +103,15 @@ function createDependencyWalker(opts) {
 	function walkDepsOf(pkgJson, fromDir, includeDevDeps = false) {
 		for (const depName of getDeps(pkgJson, includeDevDeps)) {
 			const depDir = resolveDepDirCached(depName, fromDir);
-			if (!depDir || walkVisited.has(depDir)) continue;
+			if (!depDir) continue;
 			opts.tryRegister(depDir, depName);
 			walkDeps(depDir, depName);
 		}
 	}
 	function walkDeps(pkgDir, pkgName) {
-		if (walkVisited.has(pkgDir)) return;
-		walkVisited.add(pkgDir);
+		const pkgKey = opts.getFsIdentity(pkgDir);
+		if (walkVisited.has(pkgKey)) return;
+		walkVisited.add(pkgKey);
 		const pkgJson = opts.readPkgJson(pkgDir);
 		if (!pkgJson) {
 			opts.warnings.push(`Could not read package.json for ${pkgName} (skipping dependency walk)`);
@@ -142,7 +142,15 @@ function createDependencyWalker(opts) {
 			if (wsPkg) walkDepsOf(wsPkg, wsDir);
 		}
 	}
+	function scanNestedNodeModulesDir(nodeModulesDir) {
+		for (const dirPath of listNestedNodeModulesPackageDirs(nodeModulesDir, opts.getFsIdentity)) {
+			if (!opts.tryRegister(dirPath, "unknown")) continue;
+			const pkgJson = opts.readPkgJson(dirPath);
+			walkDeps(dirPath, typeof pkgJson?.name === "string" ? pkgJson.name : "unknown");
+		}
+	}
 	return {
+		scanNestedNodeModulesDir,
 		walkKnownPackages,
 		walkProjectDeps,
 		walkWorkspacePackages
@@ -151,21 +159,19 @@ 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 getFsIdentity = createFsIdentityCache();
 	const stats = {
 		packageJsonReadCount: 0,
 		packageJsonCacheHits: 0
 	};
 	function readPackageJsonResult(dir) {
-		const key = normalizeCacheKey(dir);
+		const key = getFsIdentity(dir);
 		const cached = packageJsonCache.get(key);
 		if (cached) {
 			stats.packageJsonCacheHits += 1;
@@ -193,7 +199,7 @@ function createIntentFsCache() {
 		return readPackageJsonResult(dir).packageJson;
 	}
 	function findSkillFiles$1(dir) {
-		const key = normalizeCacheKey(dir);
+		const key = getFsIdentity(dir);
 		const cached = skillFilesCache.get(key);
 		if (cached) return [...cached];
 		const files = findSkillFiles(dir);
@@ -204,6 +210,7 @@ function createIntentFsCache() {
 		readPackageJson,
 		readPackageJsonResult,
 		findSkillFiles: findSkillFiles$1,
+		getFsIdentity,
 		getStats: () => ({ ...stats })
 	};
 }
@@ -223,36 +230,22 @@ function findPnpFile(start) {
 		dir = next;
 	}
 }
-function isYarnPnpProject(root) {
-	return findPnpFile(root) !== null;
-}
 function assertLocalNodeModulesSupported(root) {
 	if (existsSync(join(root, "deno.json")) && !existsSync(join(root, "node_modules"))) throw new Error("Deno without node_modules is not yet supported. Add `\"nodeModulesDir\": \"auto\"` to your deno.json to use intent.");
 }
-function detectPackageManager(root) {
-	const dirsToCheck = [root];
-	const wsRoot = findWorkspaceRoot(root);
-	if (wsRoot && wsRoot !== root) dirsToCheck.push(wsRoot);
-	for (const dir of dirsToCheck) {
-		if (isYarnPnpProject(dir)) return "yarn";
-		if (existsSync(join(dir, "pnpm-lock.yaml"))) return "pnpm";
-		if (existsSync(join(dir, "bun.lockb")) || existsSync(join(dir, "bun.lock"))) return "bun";
-		if (existsSync(join(dir, "yarn.lock"))) return "yarn";
-		if (existsSync(join(dir, "package-lock.json"))) return "npm";
-	}
-	return "unknown";
-}
 function loadPnpApi(root) {
 	const pnpPath = findPnpFile(root);
 	if (!pnpPath) return null;
 	try {
-		const foundApi = requireFromHere("node:module").findPnpApi?.(root);
-		if (foundApi) return foundApi;
 		const pnpModule = requireFromHere(pnpPath);
 		if (typeof pnpModule.setup === "function") pnpModule.setup();
 		if (typeof pnpModule.getDependencyTreeRoots === "function" && typeof pnpModule.getPackageInformation === "function") return pnpModule;
 		return createRequire(join(dirname(pnpPath), "package.json"))("pnpapi");
 	} catch (err) {
+		try {
+			const foundApi = requireFromHere("node:module").findPnpApi?.(root);
+			if (foundApi) return foundApi;
+		} catch {}
 		const msg = err instanceof Error ? err.message : String(err);
 		throw new Error(`Yarn PnP project detected, but Intent could not load Yarn's PnP API from ${pnpPath}: ${msg}`);
 	}
@@ -425,7 +418,8 @@ function scanForIntents(root, options = {}) {
 	const projectRoot = root ?? process.cwd();
 	const scanScope = getScanScope(options);
 	const fsCache = options.fsCache ?? createIntentFsCache();
-	const packageManager = detectPackageManager(projectRoot);
+	const workspaceRoot = findWorkspaceRoot(projectRoot);
+	const packageManager = detectPackageManager(projectRoot, [workspaceRoot]);
 	const nodeModulesDir = join(projectRoot, "node_modules");
 	const explicitGlobalNodeModules = process.env.INTENT_GLOBAL_NODE_MODULES?.trim() || null;
 	const packages = [];
@@ -485,6 +479,7 @@ function scanForIntents(root, options = {}) {
 		deriveIntentConfig,
 		discoverSkills: (skillsDir) => discoverSkills(skillsDir, fsCache),
 		getPackageDepth,
+		getFsIdentity: fsCache.getFsIdentity,
 		packageIndexes,
 		packages,
 		projectRoot,
@@ -493,8 +488,9 @@ function scanForIntents(root, options = {}) {
 		validateIntentField,
 		warnings
 	});
-	const { walkKnownPackages, walkProjectDeps, walkWorkspacePackages } = createDependencyWalker({
+	const { scanNestedNodeModulesDir, walkKnownPackages, walkProjectDeps, walkWorkspacePackages } = createDependencyWalker({
 		fsCache,
+		getFsIdentity: fsCache.getFsIdentity,
 		packages,
 		projectRoot,
 		readPkgJson,
@@ -504,7 +500,6 @@ function scanForIntents(root, options = {}) {
 	});
 	function scanPnpPackages(api) {
 		const visited = /* @__PURE__ */ new Set();
-		const workspaceRoot = findWorkspaceRoot(projectRoot);
 		const projectLocator = api.findPackageLocator?.(projectRoot.endsWith(sep) ? projectRoot : `${projectRoot}${sep}`);
 		const roots = workspaceRoot && workspaceRoot !== projectRoot && projectLocator ? [projectLocator] : api.getDependencyTreeRoots?.() ?? (api.topLevel ? [api.topLevel] : []);
 		function visit(locator) {
@@ -530,12 +525,15 @@ function scanForIntents(root, options = {}) {
 			}
 		}
 		assertLocalNodeModulesSupported(projectRoot);
+		const packageCountBeforeLocalDiscovery = packages.length;
 		walkWorkspacePackages();
 		const packageCountBeforeDependencyDiscovery = packages.length;
 		scanTarget(nodeModules.local);
 		walkKnownPackages();
 		walkProjectDeps();
-		if (packages.length === packageCountBeforeDependencyDiscovery) {
+		const shouldTryPnpFallback = packages.length === packageCountBeforeDependencyDiscovery;
+		if (nodeModules.local.path && nodeModules.local.exists && packages.length === packageCountBeforeLocalDiscovery) scanNestedNodeModulesDir(nodeModules.local.path);
+		if (shouldTryPnpFallback) {
 			const api = getPnpApi();
 			if (api) scanPnpPackages(api);
 		}
@@ -597,6 +595,7 @@ function scanIntentPackageAtRoot(packageRoot, options = {}) {
 		deriveIntentConfig,
 		discoverSkills: options.skillNameHint ? (skillsDir, packageName) => discoverSkillByNameHint(skillsDir, packageName, options.skillNameHint) : (skillsDir) => discoverSkills(skillsDir, fsCache),
 		getPackageDepth,
+		getFsIdentity: fsCache.getFsIdentity,
 		packageIndexes,
 		packages,
 		projectRoot,

package/dist/scanner-BWd4mS25.mjs

@@ -0,0 +1,6 @@
+import "./utils-Chn-30vI.mjs";
+import "./skill-paths-4kQXfQXo.mjs";
+import { n as scanIntentPackageAtRoot, t as scanForIntents } from "./scanner-B6nnctK4.mjs";
+import "./workspace-patterns-C5O4Dfpl.mjs";
+
+export { scanForIntents };

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

@@ -1,5 +1,5 @@
-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 { a as readWorkspacePatterns, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-C5O4Dfpl.mjs";
+import { t as resolveProjectContext } from "./project-context-D4mFnCs7.mjs";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { basename, join, relative } from "node:path";
 

package/dist/setup.d.mts

@@ -1,2 +1,2 @@
-import { a as runEditPackageJsonAll, c as findWorkspaceRoot, i as runEditPackageJson, l as readWorkspacePatterns, n as MonorepoResult, o as runSetupGithubActions, r as SetupGithubActionsResult, s as findPackagesWithSkills, t as EditPackageJsonResult, u as resolveWorkspacePackages } from "./setup-2SE9zYJk.mjs";
+import { a as runEditPackageJsonAll, c as findWorkspaceRoot, i as runEditPackageJson, l as readWorkspacePatterns, n as MonorepoResult, o as runSetupGithubActions, r as SetupGithubActionsResult, s as findPackagesWithSkills, t as EditPackageJsonResult, u as resolveWorkspacePackages } from "./setup-DL7qX_F-.mjs";
 export { EditPackageJsonResult, MonorepoResult, SetupGithubActionsResult, findPackagesWithSkills, findWorkspaceRoot, readWorkspacePatterns, resolveWorkspacePackages, runEditPackageJson, runEditPackageJsonAll, runSetupGithubActions };

package/dist/setup.mjs

@@ -1,6 +1,6 @@
-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";
+import "./utils-Chn-30vI.mjs";
+import { a as readWorkspacePatterns, o as resolveWorkspacePackages, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-C5O4Dfpl.mjs";
+import "./project-context-D4mFnCs7.mjs";
+import { n as runEditPackageJsonAll, r as runSetupGithubActions, t as runEditPackageJson } from "./setup-J4A9UfBB.mjs";
 
 export { findPackagesWithSkills, findWorkspaceRoot, readWorkspacePatterns, resolveWorkspacePackages, runEditPackageJson, runEditPackageJsonAll, runSetupGithubActions };

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

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

package/dist/{stale-flPZnWfI.mjs → stale-BD77r7KR.mjs}

@@ -33,7 +33,7 @@ async function runStaleCommand(targetDir, options, resolveStaleTargets) {
 	}
 }
 async function runGithubReview(targetDir, options, resolveStaleTargets) {
-	const { collectStaleReviewItems, createFailedStaleReviewItem, createWorkflowAdvisoryReviewItems, writeStaleReviewWorkflowFiles } = await import("./workflow-review-CIdJXmKP.mjs");
+	const { collectStaleReviewItems, createFailedStaleReviewItem, createWorkflowAdvisoryReviewItems, writeStaleReviewWorkflowFiles } = await import("./workflow-review-DcFipeG0.mjs");
 	const packageLabel = options.packageLabel ?? "workspace";
 	try {
 		const { reports, workflowAdvisories = [] } = await resolveStaleTargets(targetDir);

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

@@ -1,5 +1,5 @@
-import { a as parseFrontmatter, n as findSkillFiles, s as toPosixPath } from "./utils-BPDvfmcd.mjs";
-import { t as readIntentArtifacts } from "./artifact-coverage-DgWuVqUp.mjs";
+import { l as toPosixPath, r as findSkillFiles, s as parseFrontmatter } from "./utils-Chn-30vI.mjs";
+import { t as readIntentArtifacts } from "./artifact-coverage-Cqphhpfo.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { isAbsolute, join, relative, resolve } from "node:path";
 import semver from "semver";

package/dist/staleness-Dm4laJFc.mjs

@@ -0,0 +1,5 @@
+import "./utils-Chn-30vI.mjs";
+import "./artifact-coverage-Cqphhpfo.mjs";
+import { n as checkStaleness, r as readPackageName, t as buildWorkspaceCoverageSignals } from "./staleness-DChVhbCN.mjs";
+
+export { buildWorkspaceCoverageSignals, checkStaleness, readPackageName };

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

@@ -6,7 +6,7 @@ interface IntentConfig {
   requires?: Array<string>;
 }
 interface ScanResult {
-  packageManager: 'npm' | 'pnpm' | 'yarn' | 'bun' | 'unknown';
+  packageManager: PackageManager;
   packages: Array<IntentPackage>;
   warnings: Array<string>;
   conflicts: Array<VersionConflict>;
@@ -16,6 +16,7 @@ interface ScanResult {
   };
   stats?: ScanStats;
 }
+type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun' | 'unknown';
 type ScanScope = 'local' | 'local-and-global' | 'global';
 interface ScanOptions {
   includeGlobal?: boolean;
@@ -148,4 +149,4 @@ interface IntentProjectConfig {
   };
 }
 //#endregion
-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 };
+export { VersionConflict as S, ScanStats as _, IntentArtifactSet as a, StalenessReport as b, IntentConfig as c, MetaFeedbackPayload as d, MetaSkillName as f, ScanScope as g, ScanResult as h, IntentArtifactFile as i, IntentPackage as l, ScanOptions as m, FeedbackPayload as n, IntentArtifactSkill as o, PackageManager as p, IntentArtifactCoverageIgnore as r, IntentArtifactWarning as s, AgentName as t, IntentProjectConfig as u, SkillEntry as v, StalenessSignal as x, SkillStaleness as y };

package/dist/{utils-BPDvfmcd.mjs → utils-Chn-30vI.mjs}

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
-import { existsSync, readFileSync, readdirSync } from "node:fs";
-import { dirname, join, sep } from "node:path";
+import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync } from "node:fs";
+import { dirname, join, resolve, sep } from "node:path";
 import { execFileSync } from "node:child_process";
 import { parse } from "yaml";
 
@@ -11,6 +11,22 @@ import { parse } from "yaml";
 function toPosixPath(p) {
 	return p.split(sep).join("/");
 }
+function createFsIdentityCache() {
+	const cache = /* @__PURE__ */ new Map();
+	return (path) => {
+		const resolved = resolve(path);
+		const cached = cache.get(resolved);
+		if (cached) return cached;
+		let identity;
+		try {
+			identity = lstatSync(resolved).isSymbolicLink() ? realpathSync(resolved) : resolved;
+		} catch {
+			identity = resolved;
+		}
+		cache.set(resolved, identity);
+		return identity;
+	};
+}
 /**
 * Recursively find all SKILL.md files under a directory.
 */
@@ -83,6 +99,47 @@ function listNodeModulesPackageDirs(nodeModulesDir) {
 	}
 	return packageDirs;
 }
+function listNestedNodeModulesPackageDirs(nodeModulesDir, getFsIdentity = createFsIdentityCache()) {
+	const packageDirs = [];
+	const visitedNodeModulesDirs = /* @__PURE__ */ new Set();
+	const visitedPackageDirs = /* @__PURE__ */ new Set();
+	function readDir(dir) {
+		try {
+			return readdirSync(dir, {
+				withFileTypes: true,
+				encoding: "utf8"
+			});
+		} catch {
+			return [];
+		}
+	}
+	function addPackageDir(packageDir) {
+		const key = getFsIdentity(packageDir);
+		if (visitedPackageDirs.has(key)) return;
+		visitedPackageDirs.add(key);
+		if (existsSync(join(packageDir, "package.json"))) packageDirs.push(packageDir);
+		scanNodeModulesDir(join(packageDir, "node_modules"));
+	}
+	function scanNodeModulesDir(dir) {
+		const key = getFsIdentity(dir);
+		if (visitedNodeModulesDirs.has(key)) return;
+		visitedNodeModulesDirs.add(key);
+		for (const entry of readDir(dir)) {
+			if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;
+			const dirPath = join(dir, entry.name);
+			if (entry.name.startsWith("@")) {
+				for (const scoped of readDir(dirPath)) {
+					if (!scoped.isDirectory() && !scoped.isSymbolicLink()) continue;
+					addPackageDir(join(dirPath, scoped.name));
+				}
+				continue;
+			}
+			if (!entry.name.startsWith(".")) addPackageDir(dirPath);
+		}
+	}
+	scanNodeModulesDir(nodeModulesDir);
+	return packageDirs;
+}
 function detectGlobalNodeModules(packageManager) {
 	const envPath = process.env.INTENT_GLOBAL_NODE_MODULES?.trim();
 	if (envPath) return {
@@ -164,4 +221,4 @@ function parseFrontmatter(filePath) {
 }
 
 //#endregion
-export { parseFrontmatter as a, listNodeModulesPackageDirs as i, findSkillFiles as n, resolveDepDir as o, getDeps as r, toPosixPath as s, detectGlobalNodeModules as t };
+export { listNestedNodeModulesPackageDirs as a, resolveDepDir as c, getDeps as i, toPosixPath as l, detectGlobalNodeModules as n, listNodeModulesPackageDirs as o, findSkillFiles as r, parseFrontmatter as s, createFsIdentityCache as t };

package/dist/utils-Ctlz_JG-.mjs

@@ -0,0 +1,3 @@
+import { a as listNestedNodeModulesPackageDirs, c as resolveDepDir, i as getDeps, l as toPosixPath, n as detectGlobalNodeModules, o as listNodeModulesPackageDirs, r as findSkillFiles, s as parseFrontmatter, t as createFsIdentityCache } from "./utils-Chn-30vI.mjs";
+
+export { createFsIdentityCache, detectGlobalNodeModules, findSkillFiles, getDeps, listNestedNodeModulesPackageDirs, listNodeModulesPackageDirs, parseFrontmatter, resolveDepDir, toPosixPath };

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

@@ -1,8 +1,8 @@
-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-DtqVDiJv.mjs";
+import "./utils-Chn-30vI.mjs";
+import { n as findWorkspacePackages } from "./workspace-patterns-C5O4Dfpl.mjs";
+import { t as resolveProjectContext } from "./project-context-D4mFnCs7.mjs";
+import { n as isCliFailure, t as fail } from "./cli-error-DOO5bLIG.mjs";
+import { l as printWarnings } from "./cli-support-BHoEb9y1.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-DqdIC3RY.mjs")]);
+	const [{ parse: parseYaml }, { findSkillFiles }] = await Promise.all([import("yaml"), import("./utils-Ctlz_JG-.mjs")]);
 	const context = resolveProjectContext({
 		cwd: process.cwd(),
 		targetPath: dir

package/dist/{workflow-review-CIdJXmKP.mjs → workflow-review-DcFipeG0.mjs}

@@ -1,3 +1,3 @@
-import { a as writeStaleReviewWorkflowFiles, i as createWorkflowAdvisoryReviewItems, n as collectStaleReviewItems, r as createFailedStaleReviewItem, t as buildStaleReviewBody } from "./workflow-review-CwcR2ge4.mjs";
+import { a as writeStaleReviewWorkflowFiles, i as createWorkflowAdvisoryReviewItems, n as collectStaleReviewItems, r as createFailedStaleReviewItem, t as buildStaleReviewBody } from "./workflow-review--Gc_yplP.mjs";
 
 export { collectStaleReviewItems, createFailedStaleReviewItem, createWorkflowAdvisoryReviewItems, writeStaleReviewWorkflowFiles };

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

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

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

@@ -1,4 +1,4 @@
-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";
+import "./utils-Chn-30vI.mjs";
+import { a as readWorkspacePatterns, i as getWorkspaceInfo, n as findWorkspacePackages, o as resolveWorkspacePackages, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-C5O4Dfpl.mjs";
 
 export { findWorkspaceRoot, getWorkspaceInfo };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/intent",
-  "version": "0.0.40",
+  "version": "0.0.41",
   "description": "Ship compositional knowledge for AI coding agents alongside your npm packages",
   "license": "MIT",
   "type": "module",

package/dist/artifact-coverage-DA26utB1.mjs

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

package/dist/display-CmLzVAae.mjs

@@ -1,5 +0,0 @@
-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/install-ChddjnhO.mjs

@@ -1,7 +0,0 @@
-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/scanner-Ix6MmxfB.mjs

@@ -1,6 +0,0 @@
-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/staleness-Dl-m8JWM.mjs

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

package/dist/utils-DqdIC3RY.mjs

@@ -1,3 +0,0 @@
-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 };