@tanstack/intent 0.0.23 → 0.0.29

package/dist/cli.mjs

@@ -1,7 +1,10 @@
 #!/usr/bin/env node
-import { n as runInstallCommand } from "./install-BHbA_wkb.mjs";
+import "./utils-COlDcU72.mjs";
+import "./workspace-patterns-Cndd-7vB.mjs";
+import { t as resolveProjectContext } from "./project-context-D6A5sBBO.mjs";
+import { n as runInstallCommand } from "./install-BzDmD5yI.mjs";
 import { existsSync, readFileSync, readdirSync, realpathSync } from "node:fs";
-import { dirname, join, relative, sep } from "node:path";
+import { dirname, join, relative, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { cac } from "cac";
 
@@ -29,7 +32,7 @@ function getMetaDir() {
 	return join(dirname(fileURLToPath(import.meta.url)), "..", "meta");
 }
 async function scanIntentsOrFail() {
-	const { scanForIntents } = await import("./scanner-CsDGCRDm.mjs");
+	const { scanForIntents } = await import("./scanner-CP4U8F_n.mjs");
 	try {
 		return scanForIntents();
 	} catch (err) {
@@ -45,10 +48,15 @@ function readPackageName(root) {
 	}
 }
 async function resolveStaleTargets(targetDir) {
-	const resolvedRoot = targetDir ? join(process.cwd(), targetDir) : process.cwd();
-	const { checkStaleness } = await import("./staleness-Dr5-5wj5.mjs");
+	const resolvedRoot = targetDir ? resolve(process.cwd(), targetDir) : process.cwd();
+	const context = resolveProjectContext({
+		cwd: process.cwd(),
+		targetPath: targetDir
+	});
+	const { checkStaleness } = await import("./staleness-LRbiWWZK.mjs");
+	if (context.packageRoot && (context.targetSkillsDir !== null || resolvedRoot !== context.workspaceRoot)) return { reports: [await checkStaleness(context.packageRoot, readPackageName(context.packageRoot))] };
 	if (existsSync(join(resolvedRoot, "skills"))) return { reports: [await checkStaleness(resolvedRoot, readPackageName(resolvedRoot))] };
-	const { findPackagesWithSkills, findWorkspaceRoot } = await import("./setup.mjs");
+	const { findPackagesWithSkills, findWorkspaceRoot } = await import("./workspace-patterns-D_y6rlqX.mjs");
 	const workspaceRoot = findWorkspaceRoot(resolvedRoot);
 	if (workspaceRoot) {
 		const packageDirs = findPackagesWithSkills(workspaceRoot);
@@ -87,7 +95,7 @@ function printVersionConflicts(result) {
 	}
 }
 async function runListCommand(options, scanIntentsOrFail$1) {
-	const { computeSkillNameWidth, printSkillTree, printTable } = await import("./display-CuCDLPP_.mjs");
+	const { computeSkillNameWidth, printSkillTree, printTable } = await import("./display-DdmZXLZm.mjs");
 	const result = await scanIntentsOrFail$1();
 	if (options.json) {
 		console.log(JSON.stringify(result, null, 2));
@@ -151,7 +159,7 @@ async function runMetaCommand(name, metaDir) {
 		}
 		return;
 	}
-	const { parseFrontmatter } = await import("./utils-D7OKi0Rn.mjs");
+	const { parseFrontmatter } = await import("./utils-dkVvY7D7.mjs");
 	const entries = readdirSync(metaDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).filter((entry) => existsSync(join(metaDir, entry.name, "SKILL.md")));
 	if (entries.length === 0) {
 		console.log("No meta-skills found.");
@@ -286,24 +294,9 @@ function buildValidationFailure(errors, warnings) {
 	}
 	return lines.join("\n");
 }
-function isInsideMonorepo(root) {
-	let dir = join(root, "..");
-	for (let i = 0; i < 5; i++) {
-		const parentPkg = join(dir, "package.json");
-		if (existsSync(parentPkg)) try {
-			const parent = JSON.parse(readFileSync(parentPkg, "utf8"));
-			return Array.isArray(parent.workspaces) || parent.workspaces?.packages;
-		} catch {
-			return false;
-		}
-		const next = dirname(dir);
-		if (next === dir) break;
-		dir = next;
-	}
-	return false;
-}
-function collectPackagingWarnings(root) {
-	const pkgJsonPath = join(root, "package.json");
+function collectPackagingWarnings(context) {
+	if (!context.packageRoot || !context.targetPackageJsonPath) return [];
+	const pkgJsonPath = context.targetPackageJsonPath;
 	if (!existsSync(pkgJsonPath)) return [];
 	let pkgJson;
 	try {
@@ -318,24 +311,18 @@ function collectPackagingWarnings(root) {
 	const files = pkgJson.files;
 	if (Array.isArray(files)) {
 		if (!files.includes("skills")) warnings.push("\"skills\" is not in the \"files\" array — skills won't be published");
-		if (!isInsideMonorepo(root) && !files.includes("!skills/_artifacts")) warnings.push("\"!skills/_artifacts\" is not in the \"files\" array — artifacts will be published unnecessarily");
+		if (!context.isMonorepo && !files.includes("!skills/_artifacts")) warnings.push("\"!skills/_artifacts\" is not in the \"files\" array — artifacts will be published unnecessarily");
 	}
 	return warnings;
 }
-function resolvePackageRoot(startDir) {
-	let dir = startDir;
-	while (true) {
-		if (existsSync(join(dir, "package.json"))) return dir;
-		const next = dirname(dir);
-		if (next === dir) return startDir;
-		dir = next;
-	}
-}
 async function runValidateCommand(dir) {
-	const [{ parse: parseYaml }, { findSkillFiles }] = await Promise.all([import("yaml"), import("./utils-D7OKi0Rn.mjs")]);
+	const [{ parse: parseYaml }, { findSkillFiles }] = await Promise.all([import("yaml"), import("./utils-dkVvY7D7.mjs")]);
 	const targetDir = dir ?? "skills";
-	const skillsDir = join(process.cwd(), targetDir);
-	const packageRoot = resolvePackageRoot(skillsDir);
+	const context = resolveProjectContext({
+		cwd: process.cwd(),
+		targetPath: targetDir
+	});
+	const skillsDir = context.targetSkillsDir ?? resolve(process.cwd(), targetDir);
 	if (!existsSync(skillsDir)) fail(`Skills directory not found: ${skillsDir}`);
 	const errors = [];
 	const skillFiles = findSkillFiles(skillsDir);
@@ -399,7 +386,7 @@ async function runValidateCommand(dir) {
 		});
 	}
 	const artifactsDir = join(skillsDir, "_artifacts");
-	if (existsSync(artifactsDir)) for (const fileName of [
+	if (!context.isMonorepo && existsSync(artifactsDir)) for (const fileName of [
 		"domain_map.yaml",
 		"skill_spec.md",
 		"skill_tree.yaml"
@@ -430,7 +417,7 @@ async function runValidateCommand(dir) {
 			});
 		}
 	}
-	const warnings = collectPackagingWarnings(packageRoot);
+	const warnings = collectPackagingWarnings(context);
 	if (errors.length > 0) fail(buildValidationFailure(errors, warnings));
 	console.log(`✅ Validated ${skillFiles.length} skill files — all passed`);
 	if (warnings.length > 0) console.log();

package/dist/display-DdmZXLZm.mjs

@@ -0,0 +1,3 @@
+import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-hdsqb4w-.mjs";
+
+export { computeSkillNameWidth, printSkillTree, printTable };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { a as IntentProjectConfig, c as ScanResult, d as StalenessReport, i as IntentPackage, l as SkillEntry, n as FeedbackPayload, o as MetaFeedbackPayload, r as IntentConfig, s as MetaSkillName, t as AgentName, u as SkillStaleness } from "./types-ddLtccfV.mjs";
-import { c as runEditPackageJson, r as SetupGithubActionsResult, t as EditPackageJsonResult, u as runSetupGithubActions } from "./setup-BNBVotfR.mjs";
+import { a as IntentProjectConfig, c as ScanResult, d as StalenessReport, i as IntentPackage, l as SkillEntry, n as FeedbackPayload, o as MetaFeedbackPayload, r as IntentConfig, s as MetaSkillName, t as AgentName, u as SkillStaleness } from "./types-BTQ9efv-.mjs";
+import { i as runEditPackageJson, o as runSetupGithubActions, r as SetupGithubActionsResult, t as EditPackageJsonResult } from "./setup-BA9RkENh.mjs";
 
 //#region src/scanner.d.ts
 declare function scanForIntents(root?: string): ScanResult;

package/dist/index.mjs

@@ -1,7 +1,9 @@
-import { a as parseFrontmatter, n as findSkillFiles, o as resolveDepDir, r as getDeps } from "./utils-BfjM1mQe.mjs";
-import { a as runEditPackageJson, s as runSetupGithubActions } from "./setup-Nyfl1KTS.mjs";
-import { t as scanForIntents } from "./scanner-BCgNt-oI.mjs";
-import { t as checkStaleness } from "./staleness-DZKvsLVq.mjs";
+import { a as parseFrontmatter, n as findSkillFiles, o as resolveDepDir, r as getDeps } from "./utils-COlDcU72.mjs";
+import "./workspace-patterns-Cndd-7vB.mjs";
+import { t as scanForIntents } from "./scanner-B-bbXBLY.mjs";
+import { t as checkStaleness } from "./staleness-SY7-mZMH.mjs";
+import "./project-context-D6A5sBBO.mjs";
+import { r as runSetupGithubActions, t as runEditPackageJson } from "./setup-B4ZwN5Hg.mjs";
 import { readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { execFileSync, execSync } from "node:child_process";

package/dist/{install-BHbA_wkb.mjs → install-BzDmD5yI.mjs}

@@ -51,6 +51,13 @@ skills:
    Rules:
    - Use the user's own words for task descriptions
    - Include the exact path from \`npx @tanstack/intent@latest list\` output so agents can load it directly
+   - Paths should use the stable \`node_modules/<package-name>/skills/...\` format (no version numbers)
+   - If a skill path from \`list\` contains package-manager-internal directories (e.g. \`.pnpm/\`, \`.bun/\`)
+     with version numbers, it is a transitive dependency without a stable top-level symlink.
+     For these skills, do NOT embed the versioned path. Instead, add a comment telling the agent
+     how to locate the skill at runtime:
+       - task: "describe the task"
+         # To load this skill, run: npx @tanstack/intent@latest list | grep <skill-name>
    - Keep entries concise - this block is read on every agent task
    - Preserve all content outside the block tags unchanged
    - If the user is on Deno, note that this setup is best-effort today and relies on npm interop`;

package/dist/intent-library.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import "./utils-BfjM1mQe.mjs";
-import { t as INSTALL_PROMPT } from "./install-BHbA_wkb.mjs";
-import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-DhsUxNJW.mjs";
-import { t as scanLibrary } from "./library-scanner-DlWy8VeZ.mjs";
+import "./utils-COlDcU72.mjs";
+import { t as INSTALL_PROMPT } from "./install-BzDmD5yI.mjs";
+import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-hdsqb4w-.mjs";
+import { t as scanLibrary } from "./library-scanner-B51qV5aX.mjs";
 
 //#region src/intent-library.ts
 function cmdList() {

package/dist/{library-scanner-DlWy8VeZ.mjs → library-scanner-B51qV5aX.mjs}

@@ -1,6 +1,6 @@
-import { a as parseFrontmatter, o as resolveDepDir, r as getDeps } from "./utils-BfjM1mQe.mjs";
+import { a as parseFrontmatter, o as resolveDepDir, r as getDeps, s as toPosixPath } from "./utils-COlDcU72.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
-import { dirname, join, relative, sep } from "node:path";
+import { dirname, join, relative } from "node:path";
 
 //#region src/library-scanner.ts
 function readPkgJson(dir) {
@@ -44,7 +44,7 @@ function discoverSkills(skillsDir) {
 			const skillFile = join(childDir, "SKILL.md");
 			if (existsSync(skillFile)) {
 				const fm = parseFrontmatter(skillFile);
-				const relName = relative(skillsDir, childDir).split(sep).join("/");
+				const relName = toPosixPath(relative(skillsDir, childDir));
 				skills.push({
 					name: typeof fm?.name === "string" ? fm.name : relName,
 					path: skillFile,
@@ -83,11 +83,13 @@ function scanLibrary(scriptPath, _projectRoot) {
 			return;
 		}
 		const skillsDir = join(dir, "skills");
+		const skills = existsSync(skillsDir) ? discoverSkills(skillsDir) : [];
+		if (name) for (const skill of skills) skill.path = `node_modules/${name}/${toPosixPath(relative(dir, skill.path))}`;
 		packages.push({
 			name,
 			version: typeof pkg.version === "string" ? pkg.version : "0.0.0",
 			description: typeof pkg.description === "string" ? pkg.description : "",
-			skills: existsSync(skillsDir) ? discoverSkills(skillsDir) : []
+			skills
 		});
 		for (const depName of getDeps(pkg)) {
 			const depDir = resolveDepDir(depName, dir);

package/dist/library-scanner.d.mts

@@ -1,4 +1,4 @@
-import { l as SkillEntry } from "./types-ddLtccfV.mjs";
+import { l as SkillEntry } from "./types-BTQ9efv-.mjs";
 
 //#region src/library-scanner.d.ts
 interface LibraryPackage {

package/dist/library-scanner.mjs

@@ -1,4 +1,4 @@
-import "./utils-BfjM1mQe.mjs";
-import { t as scanLibrary } from "./library-scanner-DlWy8VeZ.mjs";
+import "./utils-COlDcU72.mjs";
+import { t as scanLibrary } from "./library-scanner-B51qV5aX.mjs";
 
 export { scanLibrary };

package/dist/project-context-D6A5sBBO.mjs

@@ -0,0 +1,53 @@
+import { n as findWorkspaceRoot, r as readWorkspacePatterns } from "./workspace-patterns-Cndd-7vB.mjs";
+import { existsSync, statSync } from "node:fs";
+import { dirname, join, relative, resolve } from "node:path";
+
+//#region src/core/project-context.ts
+/**
+* Resolves project structure by walking up from targetPath (or cwd) to find the
+* owning package.json, then searches for a workspace root from the package root.
+* Falls back to searching from cwd when targetPath points deep into a package.
+*/
+function resolveProjectContext({ cwd, targetPath }) {
+	const resolvedCwd = resolve(cwd);
+	const resolvedTargetPath = targetPath ? resolve(resolvedCwd, targetPath) : resolvedCwd;
+	const packageRoot = findOwningPackageRoot(resolvedTargetPath);
+	const workspaceRoot = findWorkspaceRoot(packageRoot ?? resolvedTargetPath) ?? findWorkspaceRoot(resolvedCwd);
+	const workspacePatterns = workspaceRoot ? readWorkspacePatterns(workspaceRoot) ?? [] : [];
+	return {
+		cwd: resolvedCwd,
+		workspaceRoot,
+		packageRoot,
+		isMonorepo: workspaceRoot !== null,
+		workspacePatterns,
+		targetPackageJsonPath: packageRoot ? join(packageRoot, "package.json") : null,
+		targetSkillsDir: resolveTargetSkillsDir(resolvedTargetPath, packageRoot)
+	};
+}
+function findOwningPackageRoot(startPath) {
+	let dir = toSearchDir(startPath);
+	while (true) {
+		if (existsSync(join(dir, "package.json"))) return dir;
+		const next = dirname(dir);
+		if (next === dir) return null;
+		dir = next;
+	}
+}
+function toSearchDir(path) {
+	if (!existsSync(path)) return path;
+	return statSync(path).isDirectory() ? path : dirname(path);
+}
+function resolveTargetSkillsDir(targetPath, packageRoot) {
+	if (!packageRoot) return null;
+	const packageSkillsDir = join(packageRoot, "skills");
+	if (isWithinOrEqual(targetPath, packageSkillsDir)) return packageSkillsDir;
+	if (targetPath === packageRoot && existsSync(packageSkillsDir)) return packageSkillsDir;
+	return null;
+}
+function isWithinOrEqual(path, parentDir) {
+	const rel = relative(parentDir, path);
+	return rel === "" || !rel.startsWith("..") && !rel.startsWith("/");
+}
+
+//#endregion
+export { resolveProjectContext as t };

package/dist/{scanner-BCgNt-oI.mjs → scanner-B-bbXBLY.mjs}

@@ -1,5 +1,5 @@
-import { a as parseFrontmatter, i as listNodeModulesPackageDirs, o as resolveDepDir, r as getDeps, t as detectGlobalNodeModules } from "./utils-BfjM1mQe.mjs";
-import { i as resolveWorkspacePackages, n as findWorkspaceRoot, r as readWorkspacePatterns } from "./setup-Nyfl1KTS.mjs";
+import { a as parseFrontmatter, i as listNodeModulesPackageDirs, o as resolveDepDir, r as getDeps, s as toPosixPath, t as detectGlobalNodeModules } from "./utils-COlDcU72.mjs";
+import { i as resolveWorkspacePackages, n as findWorkspaceRoot, r as readWorkspacePatterns } from "./workspace-patterns-Cndd-7vB.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join, relative, sep } from "node:path";
 
@@ -74,7 +74,7 @@ function discoverSkills(skillsDir, _baseName) {
 			const skillFile = join(childDir, "SKILL.md");
 			if (existsSync(skillFile)) {
 				const fm = parseFrontmatter(skillFile);
-				const relName = relative(skillsDir, childDir).split(sep).join("/");
+				const relName = toPosixPath(relative(skillsDir, childDir));
 				const desc = typeof fm?.description === "string" ? fm.description.replace(/\s+/g, " ").trim() : "";
 				skills.push({
 					name: typeof fm?.name === "string" ? fm.name : relName,
@@ -251,11 +251,17 @@ function scanForIntents(root) {
 			warnings.push(`${name} has a skills/ directory but could not determine repo/docs from package.json (add a "repository" field or explicit "intent" config)`);
 			return false;
 		}
+		const skills = discoverSkills(skillsDir, name);
+		if (dirPath.startsWith(projectRoot + sep) || dirPath.startsWith(projectRoot + "/")) {
+			const hasStableSymlink = name !== "" && existsSync(join(projectRoot, "node_modules", name));
+			for (const skill of skills) if (hasStableSymlink) skill.path = `node_modules/${name}/${toPosixPath(relative(dirPath, skill.path))}`;
+			else skill.path = toPosixPath(relative(projectRoot, skill.path));
+		}
 		const candidate = {
 			name,
 			version,
 			intent,
-			skills: discoverSkills(skillsDir, name),
+			skills,
 			packageRoot: dirPath
 		};
 		const existingIndex = packageIndexes.get(name);

package/dist/scanner-CP4U8F_n.mjs

@@ -0,0 +1,5 @@
+import "./utils-COlDcU72.mjs";
+import "./workspace-patterns-Cndd-7vB.mjs";
+import { t as scanForIntents } from "./scanner-B-bbXBLY.mjs";
+
+export { scanForIntents };

package/dist/{setup-Nyfl1KTS.mjs → setup-B4ZwN5Hg.mjs}

@@ -1,7 +1,7 @@
-import { n as findSkillFiles } from "./utils-BfjM1mQe.mjs";
+import { n as findWorkspaceRoot, r as readWorkspacePatterns, t as findPackagesWithSkills } from "./workspace-patterns-Cndd-7vB.mjs";
+import { t as resolveProjectContext } from "./project-context-D6A5sBBO.mjs";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { basename, join, relative } from "node:path";
-import { parse } from "yaml";
 
 //#region src/setup.ts
 function isGenericWorkspaceName(name, root) {
@@ -107,9 +107,11 @@ function runEditPackageJson(root) {
 		added: [],
 		alreadyPresent: []
 	};
-	const pkgPath = join(root, "package.json");
+	const context = resolveProjectContext({ cwd: root });
+	const packageRoot = context.packageRoot ?? root;
+	const pkgPath = join(packageRoot, "package.json");
 	if (!existsSync(pkgPath)) {
-		console.error("No package.json found in " + root);
+		console.error("No package.json found in " + packageRoot);
 		process.exitCode = 1;
 		return result;
 	}
@@ -120,6 +122,7 @@ function runEditPackageJson(root) {
 	} catch (err) {
 		const detail = err instanceof SyntaxError ? err.message : String(err);
 		console.error(`Failed to parse ${pkgPath}: ${detail}`);
+		process.exitCode = 1;
 		return result;
 	}
 	const indentMatch = raw.match(/^(\s+)"/m);
@@ -133,23 +136,7 @@ function runEditPackageJson(root) {
 	}
 	if (!Array.isArray(pkg.files)) pkg.files = [];
 	const files = pkg.files;
-	const requiredFiles = (() => {
-		let dir = join(root, "..");
-		for (let i = 0; i < 5; i++) {
-			const parentPkg = join(dir, "package.json");
-			if (existsSync(parentPkg)) {
-				try {
-					const parent = JSON.parse(readFileSync(parentPkg, "utf8"));
-					if (Array.isArray(parent.workspaces) || parent.workspaces?.packages) return true;
-				} catch {}
-				return false;
-			}
-			const next = join(dir, "..");
-			if (next === dir) break;
-			dir = next;
-		}
-		return false;
-	})() ? ["skills"] : ["skills", "!skills/_artifacts"];
+	const requiredFiles = context.isMonorepo ? ["skills"] : ["skills", "!skills/_artifacts"];
 	for (const entry of requiredFiles) if (files.includes(entry)) result.alreadyPresent.push(`files: "${entry}"`);
 	else {
 		files.push(entry);
@@ -160,88 +147,6 @@ function runEditPackageJson(root) {
 	for (const a of result.alreadyPresent) console.log(`  Already present: ${a}`);
 	return result;
 }
-function readWorkspacePatterns(root) {
-	const pnpmWs = join(root, "pnpm-workspace.yaml");
-	if (existsSync(pnpmWs)) try {
-		const config = parse(readFileSync(pnpmWs, "utf8"));
-		if (Array.isArray(config.packages)) return config.packages;
-	} catch (err) {
-		console.error(`Warning: failed to parse ${pnpmWs}: ${err instanceof Error ? err.message : err}`);
-	}
-	const pkgPath = join(root, "package.json");
-	if (existsSync(pkgPath)) try {
-		const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
-		if (Array.isArray(pkg.workspaces)) return pkg.workspaces;
-		if (Array.isArray(pkg.workspaces?.packages)) return pkg.workspaces.packages;
-	} catch (err) {
-		console.error(`Warning: failed to parse ${pkgPath}: ${err instanceof Error ? err.message : err}`);
-	}
-	return null;
-}
-/**
-* Resolve workspace glob patterns to actual package directories.
-* Handles simple patterns like "packages/*" and "packages/**".
-* Each resolved directory must contain a package.json.
-*/
-function resolveWorkspacePackages(root, patterns) {
-	const dirs = [];
-	for (const pattern of patterns) {
-		const baseDir = join(root, pattern.replace(/\/\*\*?(\/\*)?$/, ""));
-		if (!existsSync(baseDir)) continue;
-		if (pattern.includes("**")) collectPackageDirs(baseDir, dirs);
-		else if (pattern.endsWith("/*")) {
-			let entries;
-			try {
-				entries = readdirSync(baseDir, { withFileTypes: true });
-			} catch {
-				continue;
-			}
-			for (const entry of entries) {
-				if (!entry.isDirectory()) continue;
-				const dir = join(baseDir, entry.name);
-				if (existsSync(join(dir, "package.json"))) dirs.push(dir);
-			}
-		} else {
-			const dir = join(root, pattern);
-			if (existsSync(join(dir, "package.json"))) dirs.push(dir);
-		}
-	}
-	return dirs;
-}
-function collectPackageDirs(dir, result) {
-	if (existsSync(join(dir, "package.json"))) result.push(dir);
-	let entries;
-	try {
-		entries = readdirSync(dir, { withFileTypes: true });
-	} catch (err) {
-		console.error(`Warning: could not read directory ${dir}: ${err instanceof Error ? err.message : err}`);
-		return;
-	}
-	for (const entry of entries) {
-		if (!entry.isDirectory() || entry.name === "node_modules" || entry.name.startsWith(".")) continue;
-		collectPackageDirs(join(dir, entry.name), result);
-	}
-}
-function findWorkspaceRoot(start) {
-	let dir = start;
-	while (true) {
-		if (readWorkspacePatterns(dir)) return dir;
-		const next = join(dir, "..");
-		if (next === dir) return null;
-		dir = next;
-	}
-}
-/**
-* Find workspace packages that contain at least one SKILL.md file.
-*/
-function findPackagesWithSkills(root) {
-	const patterns = readWorkspacePatterns(root);
-	if (!patterns) return [];
-	return resolveWorkspacePackages(root, patterns).filter((dir) => {
-		const skillsDir = join(dir, "skills");
-		return existsSync(skillsDir) && findSkillFiles(skillsDir).length > 0;
-	});
-}
 /**
 * When run from a monorepo root, finds all workspace packages with SKILL.md
 * files and runs the given command on each. Falls back to single-package
@@ -292,4 +197,4 @@ function runSetupGithubActions(root, metaDir) {
 }
 
 //#endregion
-export { runEditPackageJson as a, resolveWorkspacePackages as i, findWorkspaceRoot as n, runEditPackageJsonAll as o, readWorkspacePatterns as r, runSetupGithubActions as s, findPackagesWithSkills as t };
+export { runEditPackageJsonAll as n, runSetupGithubActions as r, runEditPackageJson as t };

package/dist/{setup-BNBVotfR.d.mts → setup-BA9RkENh.d.mts}

@@ -1,3 +1,9 @@
+//#region src/workspace-patterns.d.ts
+declare function readWorkspacePatterns(root: string): Array<string> | null;
+declare function resolveWorkspacePackages(root: string, patterns: Array<string>): Array<string>;
+declare function findWorkspaceRoot(start: string): string | null;
+declare function findPackagesWithSkills(root: string): Array<string>;
+//#endregion
 //#region src/setup.d.ts
 interface EditPackageJsonResult {
   added: Array<string>;
@@ -12,19 +18,7 @@ interface MonorepoResult<T> {
   result: T;
 }
 declare function runEditPackageJson(root: string): EditPackageJsonResult;
-declare function readWorkspacePatterns(root: string): Array<string> | null;
-/**
- * Resolve workspace glob patterns to actual package directories.
- * Handles simple patterns like "packages/*" and "packages/**".
- * Each resolved directory must contain a package.json.
- */
-declare function resolveWorkspacePackages(root: string, patterns: Array<string>): Array<string>;
-declare function findWorkspaceRoot(start: string): string | null;
-/**
- * Find workspace packages that contain at least one SKILL.md file.
- */
-declare function findPackagesWithSkills(root: string): Array<string>;
 declare function runEditPackageJsonAll(root: string): Array<MonorepoResult<EditPackageJsonResult>> | EditPackageJsonResult;
 declare function runSetupGithubActions(root: string, metaDir: string): SetupGithubActionsResult;
 //#endregion
-export { findWorkspaceRoot as a, runEditPackageJson as c, findPackagesWithSkills as i, runEditPackageJsonAll as l, MonorepoResult as n, readWorkspacePatterns as o, SetupGithubActionsResult as r, resolveWorkspacePackages as s, EditPackageJsonResult as t, runSetupGithubActions as u };
+export { runEditPackageJsonAll as a, findWorkspaceRoot as c, runEditPackageJson as i, readWorkspacePatterns as l, MonorepoResult as n, runSetupGithubActions as o, SetupGithubActionsResult as r, findPackagesWithSkills as s, EditPackageJsonResult as t, resolveWorkspacePackages as u };

package/dist/setup.d.mts

@@ -1,2 +1,2 @@
-import { a as findWorkspaceRoot, c as runEditPackageJson, i as findPackagesWithSkills, l as runEditPackageJsonAll, n as MonorepoResult, o as readWorkspacePatterns, r as SetupGithubActionsResult, s as resolveWorkspacePackages, t as EditPackageJsonResult, u as runSetupGithubActions } from "./setup-BNBVotfR.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-BA9RkENh.mjs";
 export { EditPackageJsonResult, MonorepoResult, SetupGithubActionsResult, findPackagesWithSkills, findWorkspaceRoot, readWorkspacePatterns, resolveWorkspacePackages, runEditPackageJson, runEditPackageJsonAll, runSetupGithubActions };

package/dist/setup.mjs

@@ -1,4 +1,6 @@
-import "./utils-BfjM1mQe.mjs";
-import { a as runEditPackageJson, i as resolveWorkspacePackages, n as findWorkspaceRoot, o as runEditPackageJsonAll, r as readWorkspacePatterns, s as runSetupGithubActions, t as findPackagesWithSkills } from "./setup-Nyfl1KTS.mjs";
+import "./utils-COlDcU72.mjs";
+import { i as resolveWorkspacePackages, n as findWorkspaceRoot, r as readWorkspacePatterns, t as findPackagesWithSkills } from "./workspace-patterns-Cndd-7vB.mjs";
+import "./project-context-D6A5sBBO.mjs";
+import { n as runEditPackageJsonAll, r as runSetupGithubActions, t as runEditPackageJson } from "./setup-B4ZwN5Hg.mjs";
 
 export { findPackagesWithSkills, findWorkspaceRoot, readWorkspacePatterns, resolveWorkspacePackages, runEditPackageJson, runEditPackageJsonAll, runSetupGithubActions };

package/dist/staleness-LRbiWWZK.mjs

@@ -0,0 +1,4 @@
+import "./utils-COlDcU72.mjs";
+import { t as checkStaleness } from "./staleness-SY7-mZMH.mjs";
+
+export { checkStaleness };

package/dist/{staleness-DZKvsLVq.mjs → staleness-SY7-mZMH.mjs}

@@ -1,4 +1,4 @@
-import { a as parseFrontmatter, n as findSkillFiles } from "./utils-BfjM1mQe.mjs";
+import { a as parseFrontmatter, n as findSkillFiles } from "./utils-COlDcU72.mjs";
 import { readFileSync } from "node:fs";
 import { join, relative, sep } from "node:path";
 
@@ -12,6 +12,14 @@ function classifyVersionDrift(oldVer, newVer) {
 	if ((newParts[2] ?? 0) > (oldParts[2] ?? 0)) return "patch";
 	return null;
 }
+function readLocalVersion(packageDir) {
+	try {
+		const pkgJson = JSON.parse(readFileSync(join(packageDir, "package.json"), "utf8"));
+		return typeof pkgJson.version === "string" ? pkgJson.version : null;
+	} catch {
+		return null;
+	}
+}
 async function fetchNpmVersion(packageName) {
 	try {
 		const res = await fetch(`https://registry.npmjs.org/${encodeURIComponent(packageName)}/latest`);
@@ -22,6 +30,9 @@ async function fetchNpmVersion(packageName) {
 		return null;
 	}
 }
+async function fetchCurrentVersion(packageDir, packageName) {
+	return readLocalVersion(packageDir) ?? await fetchNpmVersion(packageName);
+}
 function isStringRecord(value) {
 	return !!value && typeof value === "object" && !Array.isArray(value) && Object.values(value).every((entry) => typeof entry === "string");
 }
@@ -65,7 +76,7 @@ async function checkStaleness(packageDir, packageName) {
 		};
 	});
 	const skillVersion = skillMetas.find((s) => s.libraryVersion)?.libraryVersion ?? null;
-	const currentVersion = await fetchNpmVersion(library);
+	const currentVersion = await fetchCurrentVersion(packageDir, library);
 	const versionDrift = skillVersion && currentVersion ? classifyVersionDrift(skillVersion, currentVersion) : null;
 	const syncState = readSyncState(packageDir);
 	return {

package/dist/{utils-BfjM1mQe.mjs → utils-COlDcU72.mjs}

@@ -1,11 +1,17 @@
 import { createRequire } from "node:module";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { dirname, join, sep } from "node:path";
 import { execFileSync } from "node:child_process";
 import { parse } from "yaml";
 
 //#region src/utils.ts
 /**
+* Convert a path to use forward slashes (for cross-platform consistency).
+*/
+function toPosixPath(p) {
+	return p.split(sep).join("/");
+}
+/**
 * Recursively find all SKILL.md files under a directory.
 */
 function findSkillFiles(dir) {
@@ -149,4 +155,4 @@ function parseFrontmatter(filePath) {
 }
 
 //#endregion
-export { parseFrontmatter as a, listNodeModulesPackageDirs as i, findSkillFiles as n, resolveDepDir as o, getDeps as r, detectGlobalNodeModules as t };
+export { parseFrontmatter as a, listNodeModulesPackageDirs as i, findSkillFiles as n, resolveDepDir as o, getDeps as r, toPosixPath as s, detectGlobalNodeModules as t };

package/dist/utils-dkVvY7D7.mjs

@@ -0,0 +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-COlDcU72.mjs";
+
+export { detectGlobalNodeModules, findSkillFiles, getDeps, listNodeModulesPackageDirs, parseFrontmatter, resolveDepDir, toPosixPath };

package/dist/workspace-patterns-Cndd-7vB.mjs

@@ -0,0 +1,167 @@
+import { n as findSkillFiles } from "./utils-COlDcU72.mjs";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { parse } from "yaml";
+
+//#region src/workspace-patterns.ts
+function normalizeWorkspacePattern(pattern) {
+	return pattern.replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+$/, "");
+}
+function normalizeWorkspacePatterns(patterns) {
+	return [...new Set(patterns.map(normalizeWorkspacePattern).filter(Boolean))].sort((a, b) => a.localeCompare(b));
+}
+function parseWorkspacePatterns(value) {
+	if (!Array.isArray(value)) return null;
+	return normalizeWorkspacePatterns(value.filter((pattern) => typeof pattern === "string"));
+}
+function hasPackageJson(dir) {
+	return existsSync(join(dir, "package.json"));
+}
+function stripJsonCommentsAndTrailingCommas(source) {
+	let result = "";
+	let inString = false;
+	let escaped = false;
+	for (let index = 0; index < source.length; index += 1) {
+		const char = source[index];
+		const next = source[index + 1];
+		if (inString) {
+			result += char;
+			if (escaped) escaped = false;
+			else if (char === "\\") escaped = true;
+			else if (char === "\"") inString = false;
+			continue;
+		}
+		if (char === "\"") {
+			inString = true;
+			result += char;
+			continue;
+		}
+		if (char === "/" && next === "/") {
+			while (index < source.length && source[index] !== "\n") index += 1;
+			if (index < source.length) result += source[index];
+			continue;
+		}
+		if (char === "/" && next === "*") {
+			const commentStart = index;
+			index += 2;
+			while (index < source.length && !(source[index] === "*" && source[index + 1] === "/")) index += 1;
+			if (index >= source.length) throw new SyntaxError(`Unterminated block comment starting at position ${commentStart}`);
+			index += 1;
+			continue;
+		}
+		if (char === ",") {
+			let lookahead = index + 1;
+			while (lookahead < source.length) {
+				const la = source[lookahead];
+				if (/\s/.test(la)) lookahead += 1;
+				else if (la === "/" && source[lookahead + 1] === "/") {
+					lookahead += 2;
+					while (lookahead < source.length && source[lookahead] !== "\n") lookahead += 1;
+				} else if (la === "/" && source[lookahead + 1] === "*") {
+					lookahead += 2;
+					while (lookahead < source.length && !(source[lookahead] === "*" && source[lookahead + 1] === "/")) lookahead += 1;
+					lookahead += 2;
+				} else break;
+			}
+			if (source[lookahead] === "}" || source[lookahead] === "]") continue;
+		}
+		result += char;
+	}
+	return result;
+}
+function readJsonFile(path, jsonc = false) {
+	const source = readFileSync(path, "utf8");
+	return JSON.parse(jsonc ? stripJsonCommentsAndTrailingCommas(source) : source);
+}
+function readWorkspacePatterns(root) {
+	const pnpmWs = join(root, "pnpm-workspace.yaml");
+	if (existsSync(pnpmWs)) try {
+		const patterns = parseWorkspacePatterns(parse(readFileSync(pnpmWs, "utf8")).packages);
+		if (patterns) return patterns;
+	} catch (err) {
+		const verb = err instanceof SyntaxError ? "parse" : "read";
+		console.error(`Warning: failed to ${verb} ${pnpmWs}: ${err instanceof Error ? err.message : err}`);
+	}
+	const pkgPath = join(root, "package.json");
+	if (existsSync(pkgPath)) try {
+		const workspaces = readJsonFile(pkgPath).workspaces;
+		const patterns = parseWorkspacePatterns(workspaces) ?? parseWorkspacePatterns(workspaces?.packages);
+		if (patterns) return patterns;
+	} catch (err) {
+		const verb = err instanceof SyntaxError ? "parse" : "read";
+		console.error(`Warning: failed to ${verb} ${pkgPath}: ${err instanceof Error ? err.message : err}`);
+	}
+	for (const denoConfigName of ["deno.json", "deno.jsonc"]) {
+		const denoConfigPath = join(root, denoConfigName);
+		if (!existsSync(denoConfigPath)) continue;
+		try {
+			const patterns = parseWorkspacePatterns(readJsonFile(denoConfigPath, true).workspace);
+			if (patterns) return patterns;
+		} catch (err) {
+			const verb = err instanceof SyntaxError ? "parse" : "read";
+			console.error(`Warning: failed to ${verb} ${denoConfigPath}: ${err instanceof Error ? err.message : err}`);
+		}
+	}
+	return null;
+}
+function resolveWorkspacePackages(root, patterns) {
+	const includedDirs = /* @__PURE__ */ new Set();
+	const excludedDirs = /* @__PURE__ */ new Set();
+	for (const pattern of normalizeWorkspacePatterns(patterns)) {
+		if (pattern.startsWith("!")) {
+			resolveWorkspacePatternSegments(root, pattern.slice(1).split("/"), excludedDirs);
+			continue;
+		}
+		resolveWorkspacePatternSegments(root, pattern.split("/"), includedDirs);
+	}
+	return [...includedDirs].filter((dir) => !excludedDirs.has(dir)).sort((a, b) => a.localeCompare(b));
+}
+/** Recursively matches path segments: `*` matches one level, `**` matches zero or more levels. */
+function resolveWorkspacePatternSegments(dir, segments, result) {
+	if (segments.length === 0) {
+		if (hasPackageJson(dir)) result.add(dir);
+		return;
+	}
+	const segment = segments[0];
+	const remainingSegments = segments.slice(1);
+	if (segment === "**") {
+		resolveWorkspacePatternSegments(dir, remainingSegments, result);
+		for (const childDir of readChildDirectories(dir)) resolveWorkspacePatternSegments(childDir, segments, result);
+		return;
+	}
+	if (segment === "*") {
+		for (const childDir of readChildDirectories(dir)) resolveWorkspacePatternSegments(childDir, remainingSegments, result);
+		return;
+	}
+	const nextDir = join(dir, segment);
+	if (!existsSync(nextDir)) return;
+	resolveWorkspacePatternSegments(nextDir, remainingSegments, result);
+}
+function readChildDirectories(dir) {
+	try {
+		return readdirSync(dir, { withFileTypes: true }).filter((entry) => entry.isDirectory() && entry.name !== "node_modules" && !entry.name.startsWith(".")).map((entry) => join(dir, entry.name));
+	} catch (err) {
+		console.error(`Warning: could not read directory ${dir}: ${err instanceof Error ? err.message : err}`);
+		return [];
+	}
+}
+function findWorkspaceRoot(start) {
+	let dir = start;
+	while (true) {
+		if (readWorkspacePatterns(dir)) return dir;
+		const next = dirname(dir);
+		if (next === dir) return null;
+		dir = next;
+	}
+}
+function findPackagesWithSkills(root) {
+	const patterns = readWorkspacePatterns(root);
+	if (!patterns) return [];
+	return resolveWorkspacePackages(root, patterns).filter((dir) => {
+		const skillsDir = join(dir, "skills");
+		return existsSync(skillsDir) && findSkillFiles(skillsDir).length > 0;
+	});
+}
+
+//#endregion
+export { resolveWorkspacePackages as i, findWorkspaceRoot as n, readWorkspacePatterns as r, findPackagesWithSkills as t };

package/dist/workspace-patterns-D_y6rlqX.mjs

@@ -0,0 +1,4 @@
+import "./utils-COlDcU72.mjs";
+import { i as resolveWorkspacePackages, n as findWorkspaceRoot, r as readWorkspacePatterns, t as findPackagesWithSkills } from "./workspace-patterns-Cndd-7vB.mjs";
+
+export { findPackagesWithSkills, findWorkspaceRoot };

package/package.json

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

package/dist/display-CuCDLPP_.mjs

@@ -1,3 +0,0 @@
-import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-DhsUxNJW.mjs";
-
-export { computeSkillNameWidth, printSkillTree, printTable };

package/dist/scanner-CsDGCRDm.mjs

@@ -1,5 +0,0 @@
-import "./utils-BfjM1mQe.mjs";
-import "./setup-Nyfl1KTS.mjs";
-import { t as scanForIntents } from "./scanner-BCgNt-oI.mjs";
-
-export { scanForIntents };

package/dist/staleness-Dr5-5wj5.mjs

@@ -1,4 +0,0 @@
-import "./utils-BfjM1mQe.mjs";
-import { t as checkStaleness } from "./staleness-DZKvsLVq.mjs";
-
-export { checkStaleness };

package/dist/utils-D7OKi0Rn.mjs

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