@tanstack/intent 0.0.42 → 0.0.44

package/dist/{cli-support-C-t4xQw0.mjs → cli-support-BNDR3l1g.mjs}

@@ -1,4 +1,4 @@
-import { t as resolveProjectContext } from "./project-context-4wzbLY9c.mjs";
+import { t as resolveProjectContext } from "./project-context-BRIMzhi4.mjs";
 import { t as fail } from "./cli-error-BrMXlbtx.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join, relative, resolve } from "node:path";
@@ -31,7 +31,7 @@ function getCheckSkillsWorkflowAdvisories(root) {
 	return [`Intent workflow update available: run \`npx @tanstack/intent@latest setup\` to refresh ${relative(process.cwd(), workflowPath) || workflowPath}.`];
 }
 async function scanIntentsOrFail(options) {
-	const { scanForIntents } = await import("./scanner-BK8rIEA3.mjs");
+	const { scanForIntents } = await import("./scanner-BV7X5n_z.mjs");
 	try {
 		return scanForIntents(void 0, options);
 	} catch (err) {
@@ -68,13 +68,13 @@ async function resolveStaleTargets(targetDir) {
 		targetPath: targetDir
 	});
 	const workflowAdvisories = getCheckSkillsWorkflowAdvisories(context.workspaceRoot ?? context.packageRoot ?? resolvedRoot);
-	const { buildWorkspaceCoverageSignals, checkStaleness, readPackageName } = await import("./staleness-Dd1kWwCz.mjs");
+	const { buildWorkspaceCoverageSignals, checkStaleness, readPackageName } = await import("./staleness-CB3qpVCq.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-CnGMcicG.mjs");
+	const { findWorkspaceRoot, getWorkspaceInfo } = await import("./workspace-patterns-Bjq_cXww.mjs");
 	const workspaceRoot = findWorkspaceRoot(resolvedRoot);
 	const workspaceInfo = workspaceRoot ? getWorkspaceInfo(workspaceRoot) : null;
 	if (workspaceInfo) {

package/dist/{cli-support-B26oUGbf.mjs → cli-support-BtHFD7gl.mjs}

@@ -1,6 +1,6 @@
-import "./utils-CF7OL__5.mjs";
-import "./workspace-patterns-FljtM2Xb.mjs";
-import "./project-context-4wzbLY9c.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-C-t4xQw0.mjs";
+import "./utils-9fhWAVua.mjs";
+import "./workspace-patterns-BffPlZ1D.mjs";
+import "./project-context-BRIMzhi4.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-BNDR3l1g.mjs";
 
 export { INTENT_CHECK_SKILLS_WORKFLOW_VERSION, coreOptionsFromGlobalFlags, getCheckSkillsWorkflowAdvisories, getMetaDir, printDebugInfo, printWarnings, resolveStaleTargets, scanIntentsOrFail, scanOptionsFromGlobalFlags };

package/dist/cli.mjs

@@ -9,31 +9,31 @@ function createCli() {
 	const cli = cac("intent");
 	cli.usage("<command> [options]");
 	cli.command("list", "Discover intent-enabled packages from the project or workspace").usage("list [--json] [--debug] [--exclude <pattern>] [--global] [--global-only]").option("--json", "Output JSON").option("--debug", "Print discovery debug details to stderr").option("--exclude <pattern>", "Exclude package name glob").option("--global", "Include global packages after project packages").option("--global-only", "List global packages only").example("list").example("list --json").example("list --global").action(async (options) => {
-		const { runListCommand } = await import("./list-DQxqa1AT.mjs");
+		const { runListCommand } = await import("./list-DrChOziX.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-3ACx3170.mjs");
+		const { runLoadCommand } = await import("./load-ll7s5E3J.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-B26oUGbf.mjs"), import("./meta-DZgsju5x.mjs")]);
+		const [{ getMetaDir }, { runMetaCommand }] = await Promise.all([import("./cli-support-BtHFD7gl.mjs"), import("./meta-BEJIfnPG.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-D0n-rBpp.mjs");
+		const { runValidateCommand } = await import("./validate-CEhp9gDs.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-B26oUGbf.mjs"), import("./install-t4jkDdD0.mjs")]);
+		const [{ scanIntentsOrFail }, { runInstallCommand }] = await Promise.all([import("./cli-support-BtHFD7gl.mjs"), import("./install-D1dsnbr9.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-B26oUGbf.mjs"), import("./scaffold-CLM6bt3c.mjs")]);
+		const [{ getMetaDir }, { runScaffoldCommand }] = await Promise.all([import("./cli-support-BtHFD7gl.mjs"), import("./scaffold-CLM6bt3c.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-B26oUGbf.mjs"), import("./stale-C6dPKQ98.mjs")]);
+		const [{ resolveStaleTargets }, { runStaleCommand }] = await Promise.all([import("./cli-support-BtHFD7gl.mjs"), import("./stale-C6dPKQ98.mjs")]);
 		await runStaleCommand(targetDir, options, resolveStaleTargets);
 	});
 	cli.command("edit-package-json", "Update package.json files so skills are published").usage("edit-package-json").action(async () => {
@@ -41,11 +41,11 @@ function createCli() {
 		await runEditPackageJsonCommand(process.cwd());
 	});
 	cli.command("setup", "Copy Intent CI workflow templates into .github/workflows/").usage("setup").action(async () => {
-		const [{ getMetaDir }, { runSetupGithubActionsCommand }] = await Promise.all([import("./cli-support-B26oUGbf.mjs"), import("./setup-github-actions-CUd1oncY.mjs")]);
+		const [{ getMetaDir }, { runSetupGithubActionsCommand }] = await Promise.all([import("./cli-support-BtHFD7gl.mjs"), import("./setup-github-actions-CUd1oncY.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-B26oUGbf.mjs"), import("./setup-github-actions-CUd1oncY.mjs")]);
+		const [{ getMetaDir }, { runSetupGithubActionsCommand }] = await Promise.all([import("./cli-support-BtHFD7gl.mjs"), import("./setup-github-actions-CUd1oncY.mjs")]);
 		await runSetupGithubActionsCommand(process.cwd(), getMetaDir());
 	});
 	cli.command("help [command]", "Display help for a command").action((commandName) => {

package/dist/{core-CEeo37aT.mjs → core-qlBI_aQL.mjs}

@@ -1,10 +1,10 @@
-import { c as resolveDepDir, i as getDeps, l as toPosixPath } from "./utils-CF7OL__5.mjs";
-import { n as scanIntentPackageAtRoot, r as createIntentFsCache, t as scanForIntents } from "./scanner-QujEINYm.mjs";
-import { n as findWorkspacePackages } from "./workspace-patterns-FljtM2Xb.mjs";
+import { i as getDeps, l as resolveDepDir, u as toPosixPath } from "./utils-9fhWAVua.mjs";
+import { n as scanIntentPackageAtRoot, r as createIntentFsCache, t as scanForIntents } from "./scanner-DaG82zNc.mjs";
+import { n as findWorkspacePackages } from "./workspace-patterns-BffPlZ1D.mjs";
 import { i as parseSkillUse, n as formatSkillUse } from "./skill-use-umYvZl94.mjs";
-import { t as resolveProjectContext } from "./project-context-4wzbLY9c.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-D8sX72Lg.mjs";
-import { existsSync, readFileSync, realpathSync } from "node:fs";
+import { t as resolveProjectContext } from "./project-context-BRIMzhi4.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-D9cjsz11.mjs";
+import { existsSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 
 //#region src/core/markdown.ts
@@ -411,14 +411,14 @@ function isResolvedPathInsidePackageRoot(path, packageRoot) {
 	const relativePath = relative(packageRoot, path);
 	return relativePath === "" || !relativePath.startsWith("..") && !isAbsolute(relativePath);
 }
-function toResolvedIntentSkill(cwd, use, resolved, debug) {
+function toResolvedIntentSkill(cwd, use, resolved, readFs, debug) {
 	let realResolvedPath;
 	try {
-		realResolvedPath = realpathSync.native(resolveFromCwd(cwd, resolved.path));
+		realResolvedPath = readFs.realpathSync.native(resolveFromCwd(cwd, resolved.path));
 	} catch {
 		throw new IntentCoreError("skill-file-not-found", `Resolved skill file was not found: ${resolved.path}`);
 	}
-	const realPackageRoot = realpathSync.native(resolveFromCwd(cwd, resolved.packageRoot));
+	const realPackageRoot = readFs.realpathSync.native(resolveFromCwd(cwd, resolved.packageRoot));
 	if (!isResolvedPathInsidePackageRoot(realResolvedPath, realPackageRoot)) throw new IntentCoreError("skill-path-outside-package", `Resolved skill path for "${use}" is outside package root: ${resolved.path}`);
 	const result = {
 		path: resolved.path,
@@ -434,6 +434,7 @@ function toResolvedIntentSkill(cwd, use, resolved, debug) {
 	return {
 		realPackageRoot,
 		realResolvedPath,
+		readFs,
 		result
 	};
 }
@@ -467,7 +468,7 @@ function resolveIntentSkillInCwd(cwd, use, options = {}) {
 	const scanOptions = toScanOptions(options);
 	const scope = getScanScope(scanOptions);
 	const fastPathResolved = resolveSkillUseFastPath(parsedUse, options, projectContext, cwd, fsCache);
-	if (fastPathResolved) return toResolvedIntentSkill(cwd, use, fastPathResolved, options.debug ? createLoadedSkillDebug({
+	if (fastPathResolved) return toResolvedIntentSkill(cwd, use, fastPathResolved, fsCache.getReadFs(), options.debug ? createLoadedSkillDebug({
 		cwd,
 		excludes: excludePatterns,
 		resolution: "fast-path",
@@ -483,7 +484,7 @@ function resolveIntentSkillInCwd(cwd, use, options = {}) {
 		if (err instanceof ResolveSkillUseError) throw new IntentCoreError(err.code, err.message, { suggestedSkills: err.suggestedSkills });
 		throw err;
 	}
-	return toResolvedIntentSkill(cwd, use, resolved, options.debug ? createLoadedSkillDebug({
+	return toResolvedIntentSkill(cwd, use, resolved, fsCache.getReadFs(), options.debug ? createLoadedSkillDebug({
 		cwd,
 		excludes: excludePatterns,
 		resolution: "full-scan",
@@ -499,7 +500,7 @@ function loadIntentSkill(use, options = {}) {
 	const cwd = resolveCoreCwd(options);
 	const resolved = resolveIntentSkillInCwd(cwd, use, options);
 	const content = rewriteLoadedSkillMarkdownDestinations({
-		content: readFileSync(resolved.realResolvedPath, "utf8"),
+		content: resolved.readFs.readFileSync(resolved.realResolvedPath, "utf8"),
 		cwd,
 		packageRoot: resolved.realPackageRoot,
 		skillFilePath: resolved.realResolvedPath

package/dist/core.mjs

@@ -1,9 +1,9 @@
-import "./utils-CF7OL__5.mjs";
-import "./skill-paths-Cc0-Y331.mjs";
-import "./scanner-QujEINYm.mjs";
-import "./workspace-patterns-FljtM2Xb.mjs";
-import "./project-context-4wzbLY9c.mjs";
-import "./resolver-D8sX72Lg.mjs";
-import { i as resolveIntentSkill, n as listIntentSkills, r as loadIntentSkill, t as IntentCoreError } from "./core-CEeo37aT.mjs";
+import "./utils-9fhWAVua.mjs";
+import "./skill-paths-B-j0dWDA.mjs";
+import "./scanner-DaG82zNc.mjs";
+import "./workspace-patterns-BffPlZ1D.mjs";
+import "./project-context-BRIMzhi4.mjs";
+import "./resolver-D9cjsz11.mjs";
+import { i as resolveIntentSkill, n as listIntentSkills, r as loadIntentSkill, t as IntentCoreError } from "./core-qlBI_aQL.mjs";
 
 export { IntentCoreError, listIntentSkills, loadIntentSkill, resolveIntentSkill };

package/dist/{display-BdSvrwWJ.mjs → display-0FnzlKRq.mjs}

@@ -1,5 +1,5 @@
-import "./utils-CF7OL__5.mjs";
-import { n as isStableLoadPath, t as formatRuntimeSkillLookupHint } from "./skill-paths-Cc0-Y331.mjs";
+import "./utils-9fhWAVua.mjs";
+import { n as isStableLoadPath, t as formatRuntimeSkillLookupHint } from "./skill-paths-B-j0dWDA.mjs";
 
 //#region src/display.ts
 function padColumn(text, width) {

package/dist/index.d.mts

@@ -1,6 +1,46 @@
 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-CIha6LtJ.mjs";
 import { i as runEditPackageJson, o as runSetupGithubActions, r as SetupGithubActionsResult, t as EditPackageJsonResult } from "./setup-DhMqESd3.mjs";
+import { closeSync, existsSync, lstatSync, openSync, readFileSync, readSync, readdirSync, realpathSync } from "node:fs";
 
+//#region src/utils.d.ts
+
+/**
+ * The subset of `node:fs` the scanner reads through. Under Yarn PnP this is
+ * swapped for Yarn's libzip-patched `fs` so reads can reach files inside
+ * `.yarn/cache/*.zip` (see scanner `loadPnpApi`). The static `node:fs` named
+ * imports cannot be used directly for that, because their bindings are captured
+ * before Yarn's `setup()` patches the CommonJS `fs` module.
+ */
+interface ReadFs {
+  existsSync: typeof existsSync;
+  lstatSync: typeof lstatSync;
+  readFileSync: typeof readFileSync;
+  readdirSync: typeof readdirSync;
+  realpathSync: typeof realpathSync;
+  /**
+   * Optional low-level read primitives. When present (always on `node:fs` and
+   * Yarn's libzip-patched module) `parseFrontmatter` reads only the leading
+   * region of a file instead of its whole body.
+   */
+  openSync?: typeof openSync;
+  readSync?: typeof readSync;
+  closeSync?: typeof closeSync;
+}
+/**
+ * Recursively find all SKILL.md files under a directory.
+ */
+declare function findSkillFiles(dir: string, fs?: ReadFs): Array<string>;
+/**
+ * Read dependencies and peerDependencies (and optionally devDependencies) from
+ * a parsed package.json object.
+ */
+declare function getDeps(pkgJson: Record<string, unknown>, includeDevDeps?: boolean): Array<string>;
+declare function resolveDepDir(depName: string, parentDir: string): string | null;
+/**
+ * Parse YAML frontmatter from a file. Returns null if no frontmatter or on error.
+ */
+declare function parseFrontmatter(filePath: string, fs?: ReadFs): Record<string, unknown> | null;
+//#endregion
 //#region src/scanner.d.ts
 declare function scanForIntents(root?: string, options?: ScanOptions): ScanResult;
 //#endregion
@@ -52,27 +92,6 @@ declare function submitMetaFeedback(payload: MetaFeedbackPayload, opts: {
   outputPath?: string;
 }): SubmitResult;
 //#endregion
-//#region src/utils.d.ts
-/**
- * Recursively find all SKILL.md files under a directory.
- */
-declare function findSkillFiles(dir: string): Array<string>;
-/**
- * Read dependencies and peerDependencies (and optionally devDependencies) from
- * a parsed package.json object.
- */
-declare function getDeps(pkgJson: Record<string, unknown>, includeDevDeps?: boolean): Array<string>;
-/**
- * Resolve the directory of a dependency by name. Tries createRequire first
- * (handles pnpm symlinks), then falls back to walking up node_modules
- * directories (handles packages with export maps that block ./package.json).
- */
-declare function resolveDepDir(depName: string, parentDir: string): string | null;
-/**
- * Parse YAML frontmatter from a file. Returns null if no frontmatter or on error.
- */
-declare function parseFrontmatter(filePath: string): Record<string, unknown> | null;
-//#endregion
 //#region src/skill-use.d.ts
 interface SkillUse {
   packageName: string;

package/dist/index.mjs

@@ -1,14 +1,14 @@
-import { c as resolveDepDir, i as getDeps, r as findSkillFiles, s as parseFrontmatter } from "./utils-CF7OL__5.mjs";
-import "./skill-paths-Cc0-Y331.mjs";
-import { t as scanForIntents } from "./scanner-QujEINYm.mjs";
-import "./workspace-patterns-FljtM2Xb.mjs";
+import { c as parseFrontmatter, i as getDeps, l as resolveDepDir, r as findSkillFiles } from "./utils-9fhWAVua.mjs";
+import "./skill-paths-B-j0dWDA.mjs";
+import { t as scanForIntents } from "./scanner-DaG82zNc.mjs";
+import "./workspace-patterns-BffPlZ1D.mjs";
 import { t as readIntentArtifacts } from "./artifact-coverage-DgWuVqUp.mjs";
-import { n as checkStaleness } from "./staleness-BwcLygsY.mjs";
+import { n as checkStaleness } from "./staleness-BGFfic-Y.mjs";
 import { n as collectStaleReviewItems, r as createFailedStaleReviewItem, t as buildStaleReviewBody } from "./workflow-review-D9Fg1G0P.mjs";
 import { i as parseSkillUse, n as formatSkillUse, r as isSkillUseParseError, t as SkillUseParseError } from "./skill-use-umYvZl94.mjs";
-import "./project-context-4wzbLY9c.mjs";
-import { i as resolveSkillUse, n as isResolveSkillUseError, t as ResolveSkillUseError } from "./resolver-D8sX72Lg.mjs";
-import { r as runSetupGithubActions, t as runEditPackageJson } from "./setup-BElEzHxS.mjs";
+import "./project-context-BRIMzhi4.mjs";
+import { i as resolveSkillUse, n as isResolveSkillUseError, t as ResolveSkillUseError } from "./resolver-D9cjsz11.mjs";
+import { r as runSetupGithubActions, t as runEditPackageJson } from "./setup-BklJkH_6.mjs";
 import { readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { execFileSync, execSync } from "node:child_process";

package/dist/{install-t4jkDdD0.mjs → install-D1dsnbr9.mjs}

@@ -1,10 +1,10 @@
-import "./utils-CF7OL__5.mjs";
-import "./workspace-patterns-FljtM2Xb.mjs";
+import "./utils-9fhWAVua.mjs";
+import "./workspace-patterns-BffPlZ1D.mjs";
 import { t as detectPackageManager } from "./package-manager-BUgTjW9Q.mjs";
 import { i as parseSkillUse, n as formatSkillUse } from "./skill-use-umYvZl94.mjs";
-import "./project-context-4wzbLY9c.mjs";
+import "./project-context-BRIMzhi4.mjs";
 import { t as fail } from "./cli-error-BrMXlbtx.mjs";
-import { c as scanOptionsFromGlobalFlags, l as printWarnings } from "./cli-support-C-t4xQw0.mjs";
+import { c as scanOptionsFromGlobalFlags, l as printWarnings } from "./cli-support-BNDR3l1g.mjs";
 import { t as formatIntentCommand } from "./command-runner-C0yCOHLi.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join, relative } from "node:path";

package/dist/{list-DQxqa1AT.mjs → list-DrChOziX.mjs}

@@ -1,11 +1,11 @@
-import "./utils-CF7OL__5.mjs";
-import "./skill-paths-Cc0-Y331.mjs";
-import "./scanner-QujEINYm.mjs";
-import "./workspace-patterns-FljtM2Xb.mjs";
-import "./project-context-4wzbLY9c.mjs";
-import "./resolver-D8sX72Lg.mjs";
-import { n as listIntentSkills } from "./core-CEeo37aT.mjs";
-import { a as printDebugInfo, l as printWarnings, n as coreOptionsFromGlobalFlags } from "./cli-support-C-t4xQw0.mjs";
+import "./utils-9fhWAVua.mjs";
+import "./skill-paths-B-j0dWDA.mjs";
+import "./scanner-DaG82zNc.mjs";
+import "./workspace-patterns-BffPlZ1D.mjs";
+import "./project-context-BRIMzhi4.mjs";
+import "./resolver-D9cjsz11.mjs";
+import { n as listIntentSkills } from "./core-qlBI_aQL.mjs";
+import { a as printDebugInfo, l as printWarnings, n as coreOptionsFromGlobalFlags } from "./cli-support-BNDR3l1g.mjs";
 import { t as formatIntentCommand } from "./command-runner-C0yCOHLi.mjs";
 
 //#region src/commands/list.ts
@@ -59,7 +59,7 @@ async function runListCommand(options, _scanIntentsOrFail) {
 		console.log(JSON.stringify(jsonResult, null, 2));
 		return;
 	}
-	const { computeSkillNameWidth, printSkillTree, printTable } = await import("./display-BdSvrwWJ.mjs");
+	const { computeSkillNameWidth, printSkillTree, printTable } = await import("./display-0FnzlKRq.mjs");
 	if (result.packages.length === 0) {
 		console.log("No intent-enabled packages found.");
 		if (result.warnings.length > 0) {

package/dist/{load-3ACx3170.mjs → load-ll7s5E3J.mjs}

@@ -1,12 +1,12 @@
-import "./utils-CF7OL__5.mjs";
-import "./skill-paths-Cc0-Y331.mjs";
-import "./scanner-QujEINYm.mjs";
-import "./workspace-patterns-FljtM2Xb.mjs";
-import "./project-context-4wzbLY9c.mjs";
-import "./resolver-D8sX72Lg.mjs";
+import "./utils-9fhWAVua.mjs";
+import "./skill-paths-B-j0dWDA.mjs";
+import "./scanner-DaG82zNc.mjs";
+import "./workspace-patterns-BffPlZ1D.mjs";
+import "./project-context-BRIMzhi4.mjs";
+import "./resolver-D9cjsz11.mjs";
 import { t as fail } from "./cli-error-BrMXlbtx.mjs";
-import { i as resolveIntentSkill, r as loadIntentSkill, t as IntentCoreError } from "./core-CEeo37aT.mjs";
-import { a as printDebugInfo, n as coreOptionsFromGlobalFlags } from "./cli-support-C-t4xQw0.mjs";
+import { i as resolveIntentSkill, r as loadIntentSkill, t as IntentCoreError } from "./core-qlBI_aQL.mjs";
+import { a as printDebugInfo, n as coreOptionsFromGlobalFlags } from "./cli-support-BNDR3l1g.mjs";
 
 //#region src/commands/load.ts
 function printLoadDebug(loaded) {

package/dist/{meta-DZgsju5x.mjs → meta-BEJIfnPG.mjs}

@@ -16,7 +16,7 @@ async function runMetaCommand(name, metaDir) {
 		}
 		return;
 	}
-	const { parseFrontmatter } = await import("./utils-DTvYXAsM.mjs");
+	const { parseFrontmatter } = await import("./utils-CSPzvaFu.mjs");
 	const entries = readdirSync(metaDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).filter((entry) => existsSync(join(metaDir, entry.name, "SKILL.md")));
 	if (entries.length === 0) {
 		console.log("No meta-skills found.");

package/dist/{project-context-4wzbLY9c.mjs → project-context-BRIMzhi4.mjs}

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

package/dist/{resolver-D8sX72Lg.mjs → resolver-D9cjsz11.mjs}

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

package/dist/scanner-BV7X5n_z.mjs

@@ -0,0 +1,6 @@
+import "./utils-9fhWAVua.mjs";
+import "./skill-paths-B-j0dWDA.mjs";
+import { n as scanIntentPackageAtRoot, t as scanForIntents } from "./scanner-DaG82zNc.mjs";
+import "./workspace-patterns-BffPlZ1D.mjs";
+
+export { scanForIntents };

package/dist/{scanner-QujEINYm.mjs → scanner-DaG82zNc.mjs}

@@ -1,9 +1,9 @@
-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-CF7OL__5.mjs";
-import { r as rewriteSkillLoadPaths } from "./skill-paths-Cc0-Y331.mjs";
-import { n as findWorkspacePackages, r as findWorkspaceRoot } from "./workspace-patterns-FljtM2Xb.mjs";
+import { a as listNestedNodeModulesPackageDirs, c as parseFrontmatter, i as getDeps, l as resolveDepDir, n as detectGlobalNodeModules, o as listNodeModulesPackageDirs, r as findSkillFiles, s as nodeReadFs, t as createFsIdentityCache, u as toPosixPath } from "./utils-9fhWAVua.mjs";
+import { r as rewriteSkillLoadPaths } from "./skill-paths-B-j0dWDA.mjs";
+import { n as findWorkspacePackages, r as findWorkspaceRoot } from "./workspace-patterns-BffPlZ1D.mjs";
 import { t as detectPackageManager } from "./package-manager-BUgTjW9Q.mjs";
 import { createRequire } from "node:module";
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import semver from "semver";
 
@@ -35,7 +35,7 @@ function createPackageRegistrar(opts) {
 	function tryRegister(dirPath, fallbackName, source = "local") {
 		if (!shouldAttemptPackageRoot(dirPath)) return false;
 		const skillsDir = join(dirPath, "skills");
-		if (!existsSync(skillsDir)) return false;
+		if (!opts.exists(skillsDir)) return false;
 		const pkgJson = opts.readPkgJson(dirPath);
 		if (!pkgJson) {
 			opts.warnings.push(`Could not read package.json for ${dirPath}`);
@@ -117,7 +117,7 @@ function createDependencyWalker(opts) {
 			opts.warnings.push(`Could not read package.json for ${pkgName} (skipping dependency walk)`);
 			return;
 		}
-		walkDepsOf(pkgJson, pkgDir);
+		walkDepsOf(pkgJson, pkgKey);
 	}
 	function walkKnownPackages() {
 		for (const pkg of [...opts.packages]) walkDeps(pkg.packageRoot, pkg.name);
@@ -165,7 +165,8 @@ function isRecord(value) {
 function createIntentFsCache() {
 	const packageJsonCache = /* @__PURE__ */ new Map();
 	const skillFilesCache = /* @__PURE__ */ new Map();
-	const getFsIdentity = createFsIdentityCache();
+	let activeFs = nodeReadFs;
+	const getFsIdentity = createFsIdentityCache(() => activeFs);
 	const stats = {
 		packageJsonReadCount: 0,
 		packageJsonCacheHits: 0
@@ -179,7 +180,7 @@ function createIntentFsCache() {
 		}
 		stats.packageJsonReadCount += 1;
 		try {
-			const parsed = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
+			const parsed = JSON.parse(activeFs.readFileSync(join(dir, "package.json"), "utf8"));
 			const result = {
 				packageJson: isRecord(parsed) ? parsed : null,
 				error: null
@@ -202,7 +203,7 @@ function createIntentFsCache() {
 		const key = getFsIdentity(dir);
 		const cached = skillFilesCache.get(key);
 		if (cached) return [...cached];
-		const files = findSkillFiles(dir);
+		const files = findSkillFiles(dir, activeFs);
 		skillFilesCache.set(key, files);
 		return [...files];
 	}
@@ -211,7 +212,12 @@ function createIntentFsCache() {
 		readPackageJsonResult,
 		findSkillFiles: findSkillFiles$1,
 		getFsIdentity,
-		getStats: () => ({ ...stats })
+		getStats: () => ({ ...stats }),
+		useFs: (fs) => {
+			activeFs = fs;
+		},
+		getReadFs: () => activeFs,
+		exists: (path) => activeFs.existsSync(path)
 	};
 }
 
@@ -237,15 +243,29 @@ function assertLocalNodeModulesSupported(root) {
 function loadPnpApi(root) {
 	const pnpPath = findPnpFile(root);
 	if (!pnpPath) return null;
+	const moduleApi = requireFromHere("node:module");
+	const originalResolveFilename = moduleApi._resolveFilename;
+	const readFs = requireFromHere("node:fs");
 	try {
 		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");
+		moduleApi._resolveFilename = originalResolveFilename;
+		if (typeof pnpModule.getDependencyTreeRoots === "function" && typeof pnpModule.getPackageInformation === "function") return {
+			api: pnpModule,
+			readFs
+		};
+		return {
+			api: createRequire(join(dirname(pnpPath), "package.json"))("pnpapi"),
+			readFs
+		};
 	} catch (err) {
+		moduleApi._resolveFilename = originalResolveFilename;
 		try {
-			const foundApi = requireFromHere("node:module").findPnpApi?.(root);
-			if (foundApi) return foundApi;
+			const foundApi = moduleApi.findPnpApi?.(root);
+			if (foundApi) return {
+				api: foundApi,
+				readFs
+			};
 		} 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}`);
@@ -303,8 +323,8 @@ function deriveIntentConfig(pkgJson) {
 		requires
 	};
 }
-function readSkillEntry(skillsDir, childDir, skillFile) {
-	const fm = parseFrontmatter(skillFile);
+function readSkillEntry(skillsDir, childDir, skillFile, readFs = nodeReadFs) {
+	const fm = parseFrontmatter(skillFile, readFs);
 	const relName = toPosixPath(relative(skillsDir, childDir));
 	const desc = typeof fm?.description === "string" ? fm.description.replace(/\s+/g, " ").trim() : "";
 	return {
@@ -315,7 +335,7 @@ function readSkillEntry(skillsDir, childDir, skillFile) {
 		framework: typeof fm?.framework === "string" ? fm.framework : void 0
 	};
 }
-function discoverSkillByNameHint(skillsDir, packageName, skillNameHint) {
+function discoverSkillByNameHint(skillsDir, packageName, skillNameHint, readFs = nodeReadFs) {
 	const skills = [];
 	const seen = /* @__PURE__ */ new Set();
 	const skillNameHints = getSkillNameHints(packageName, skillNameHint);
@@ -323,8 +343,8 @@ function discoverSkillByNameHint(skillsDir, packageName, skillNameHint) {
 		const resolvedHint = resolveSkillNameHintPath(skillsDir, hint);
 		if (!resolvedHint) continue;
 		const { childDir, skillFile } = resolvedHint;
-		if (!existsSync(skillFile)) continue;
-		const skill = readSkillEntry(skillsDir, childDir, skillFile);
+		if (!readFs.existsSync(skillFile)) continue;
+		const skill = readSkillEntry(skillsDir, childDir, skillFile, readFs);
 		if (skill.name !== hint || seen.has(skill.name)) continue;
 		seen.add(skill.name);
 		skills.push(skill);
@@ -332,10 +352,11 @@ function discoverSkillByNameHint(skillsDir, packageName, skillNameHint) {
 	return skills;
 }
 function discoverSkills(skillsDir, fsCache) {
+	const readFs = fsCache.getReadFs();
 	return fsCache.findSkillFiles(skillsDir).flatMap((skillFile) => {
 		const childDir = dirname(skillFile);
 		if (childDir === skillsDir) return [];
-		return [readSkillEntry(skillsDir, childDir, skillFile)];
+		return [readSkillEntry(skillsDir, childDir, skillFile, readFs)];
 	});
 }
 function getPackageShortName(packageName) {
@@ -446,7 +467,11 @@ function scanForIntents(root, options = {}) {
 	let pnpApi;
 	function getPnpApi() {
 		if (scanScope === "global") return null;
-		if (pnpApi === void 0) pnpApi = loadPnpApi(projectRoot);
+		if (pnpApi === void 0) {
+			const loaded = loadPnpApi(projectRoot);
+			pnpApi = loaded?.api ?? null;
+			if (loaded) fsCache.useFs(loaded.readFs);
+		}
 		return pnpApi;
 	}
 	function getStats() {
@@ -481,6 +506,7 @@ function scanForIntents(root, options = {}) {
 		discoverSkills: (skillsDir) => discoverSkills(skillsDir, fsCache),
 		getPackageDepth,
 		getFsIdentity: fsCache.getFsIdentity,
+		exists: fsCache.exists,
 		packageIndexes,
 		packages,
 		projectRoot,
@@ -594,9 +620,10 @@ function scanIntentPackageAtRoot(packageRoot, options = {}) {
 	const { tryRegister } = createPackageRegistrar({
 		comparePackageVersions,
 		deriveIntentConfig,
-		discoverSkills: options.skillNameHint ? (skillsDir, packageName) => discoverSkillByNameHint(skillsDir, packageName, options.skillNameHint) : (skillsDir) => discoverSkills(skillsDir, fsCache),
+		discoverSkills: options.skillNameHint ? (skillsDir, packageName) => discoverSkillByNameHint(skillsDir, packageName, options.skillNameHint, fsCache.getReadFs()) : (skillsDir) => discoverSkills(skillsDir, fsCache),
 		getPackageDepth,
 		getFsIdentity: fsCache.getFsIdentity,
+		exists: fsCache.exists,
 		packageIndexes,
 		packages,
 		projectRoot,

package/dist/{setup-BElEzHxS.mjs → setup-BklJkH_6.mjs}

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

package/dist/setup.mjs

@@ -1,6 +1,6 @@
-import "./utils-CF7OL__5.mjs";
-import { a as readWorkspacePatterns, o as resolveWorkspacePackages, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-FljtM2Xb.mjs";
-import "./project-context-4wzbLY9c.mjs";
-import { n as runEditPackageJsonAll, r as runSetupGithubActions, t as runEditPackageJson } from "./setup-BElEzHxS.mjs";
+import "./utils-9fhWAVua.mjs";
+import { a as readWorkspacePatterns, o as resolveWorkspacePackages, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-BffPlZ1D.mjs";
+import "./project-context-BRIMzhi4.mjs";
+import { n as runEditPackageJsonAll, r as runSetupGithubActions, t as runEditPackageJson } from "./setup-BklJkH_6.mjs";
 
 export { findPackagesWithSkills, findWorkspaceRoot, readWorkspacePatterns, resolveWorkspacePackages, runEditPackageJson, runEditPackageJsonAll, runSetupGithubActions };

package/dist/{skill-paths-Cc0-Y331.mjs → skill-paths-B-j0dWDA.mjs}

@@ -1,4 +1,4 @@
-import { l as toPosixPath } from "./utils-CF7OL__5.mjs";
+import { u as toPosixPath } from "./utils-9fhWAVua.mjs";
 import { existsSync } from "node:fs";
 import { join, relative } from "node:path";
 

package/dist/{staleness-BwcLygsY.mjs → staleness-BGFfic-Y.mjs}

@@ -1,4 +1,4 @@
-import { l as toPosixPath, r as findSkillFiles, s as parseFrontmatter } from "./utils-CF7OL__5.mjs";
+import { c as parseFrontmatter, r as findSkillFiles, u as toPosixPath } from "./utils-9fhWAVua.mjs";
 import { t as readIntentArtifacts } from "./artifact-coverage-DgWuVqUp.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { isAbsolute, join, relative, resolve } from "node:path";

package/dist/{staleness-Dd1kWwCz.mjs → staleness-CB3qpVCq.mjs}

@@ -1,5 +1,5 @@
-import "./utils-CF7OL__5.mjs";
+import "./utils-9fhWAVua.mjs";
 import "./artifact-coverage-DgWuVqUp.mjs";
-import { n as checkStaleness, r as readPackageName, t as buildWorkspaceCoverageSignals } from "./staleness-BwcLygsY.mjs";
+import { n as checkStaleness, r as readPackageName, t as buildWorkspaceCoverageSignals } from "./staleness-BGFfic-Y.mjs";
 
 export { buildWorkspaceCoverageSignals, checkStaleness, readPackageName };

package/dist/{utils-CF7OL__5.mjs → utils-9fhWAVua.mjs}

@@ -1,25 +1,36 @@
 import { createRequire } from "node:module";
-import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync } from "node:fs";
+import { closeSync, existsSync, lstatSync, openSync, readFileSync, readSync, readdirSync, realpathSync } from "node:fs";
 import { dirname, join, resolve, sep } from "node:path";
 import { execFileSync } from "node:child_process";
 import { parse } from "yaml";
 
 //#region src/utils.ts
+const nodeReadFs = {
+	existsSync,
+	lstatSync,
+	readFileSync,
+	readdirSync,
+	realpathSync,
+	openSync,
+	readSync,
+	closeSync
+};
 /**
 * Convert a path to use forward slashes (for cross-platform consistency).
 */
 function toPosixPath(p) {
 	return p.split(sep).join("/");
 }
-function createFsIdentityCache() {
+function createFsIdentityCache(getFs = () => nodeReadFs) {
 	const cache = /* @__PURE__ */ new Map();
 	return (path) => {
 		const resolved = resolve(path);
 		const cached = cache.get(resolved);
 		if (cached) return cached;
+		const fs = getFs();
 		let identity;
 		try {
-			identity = lstatSync(resolved).isSymbolicLink() ? realpathSync(resolved) : resolved;
+			identity = fs.lstatSync(resolved).isSymbolicLink() ? fs.realpathSync(resolved) : resolved;
 		} catch {
 			identity = resolved;
 		}
@@ -30,24 +41,26 @@ function createFsIdentityCache() {
 /**
 * Recursively find all SKILL.md files under a directory.
 */
-function findSkillFiles(dir) {
+function findSkillFiles(dir, fs = nodeReadFs) {
 	const files = [];
-	if (!existsSync(dir)) return files;
+	collectSkillFiles(dir, fs, files);
+	return files;
+}
+function collectSkillFiles(dir, fs, files) {
 	let entries;
 	try {
-		entries = readdirSync(dir, {
+		entries = fs.readdirSync(dir, {
 			withFileTypes: true,
 			encoding: "utf8"
 		});
 	} catch {
-		return files;
+		return;
 	}
 	for (const entry of entries) {
 		const fullPath = join(dir, entry.name);
-		if (entry.isDirectory()) files.push(...findSkillFiles(fullPath));
+		if (entry.isDirectory()) collectSkillFiles(fullPath, fs, files);
 		else if (entry.name === "SKILL.md") files.push(fullPath);
 	}
-	return files;
 }
 /**
 * Read dependencies and peerDependencies (and optionally devDependencies) from
@@ -67,7 +80,6 @@ function getDeps(pkgJson, includeDevDeps = false) {
 	return [...deps];
 }
 function listNodeModulesPackageDirs(nodeModulesDir) {
-	if (!existsSync(nodeModulesDir)) return [];
 	let topEntries;
 	try {
 		topEntries = readdirSync(nodeModulesDir, {
@@ -184,9 +196,25 @@ function detectGlobalNodeModules(packageManager) {
 * (handles pnpm symlinks), then falls back to walking up node_modules
 * directories (handles packages with export maps that block ./package.json).
 */
+/**
+* `createRequire` builds a full module-resolution context; constructing it is
+* non-trivial and `resolveDepDir` is called once per dependency, often many
+* times from the same `parentDir` (every sibling dep of one package). Cache the
+* require function by its base `package.json` path. `req.resolve` still hits the
+* live filesystem on each call, so cached entries never go stale.
+*/
+const requireForBaseCache = /* @__PURE__ */ new Map();
+function getRequireForBase(basePackageJson) {
+	let req = requireForBaseCache.get(basePackageJson);
+	if (!req) {
+		req = createRequire(basePackageJson);
+		requireForBaseCache.set(basePackageJson, req);
+	}
+	return req;
+}
 function resolveDepDir(depName, parentDir) {
 	try {
-		return dirname(createRequire(join(parentDir, "package.json")).resolve(join(depName, "package.json")));
+		return dirname(getRequireForBase(join(parentDir, "package.json")).resolve(join(depName, "package.json")));
 	} catch (err) {
 		const code = err && typeof err === "object" && "code" in err ? err.code : void 0;
 		if (code && code !== "MODULE_NOT_FOUND" && code !== "ERR_PACKAGE_PATH_NOT_EXPORTED") console.warn(`Warning: could not resolve ${depName} from ${parentDir}: ${err instanceof Error ? err.message : String(err)}`);
@@ -204,21 +232,51 @@ function resolveDepDir(depName, parentDir) {
 /**
 * Parse YAML frontmatter from a file. Returns null if no frontmatter or on error.
 */
-function parseFrontmatter(filePath) {
-	let content;
+function parseFrontmatter(filePath, fs = nodeReadFs) {
+	const content = readFrontmatterRegion(filePath, fs);
+	if (content === null) return null;
+	const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+	if (!match?.[1]) return null;
 	try {
-		content = readFileSync(filePath, "utf8");
+		return parse(match[1]);
 	} catch {
 		return null;
 	}
-	const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-	if (!match?.[1]) return null;
+}
+/** Max bytes read when probing a file's leading frontmatter region. */
+const FRONTMATTER_READ_LIMIT = 16 * 1024;
+/** Reused across calls; safe because reads are synchronous and single-threaded. */
+const frontmatterBuffer = Buffer.allocUnsafe(FRONTMATTER_READ_LIMIT);
+/**
+* Read just the leading region of a file, enough to cover its frontmatter,
+* instead of its whole body. Falls back to a full read when the bounded read
+* primitives are unavailable or the frontmatter exceeds the probe limit.
+*/
+function readFrontmatterRegion(filePath, fs) {
+	if (fs.openSync && fs.readSync && fs.closeSync) {
+		let region = null;
+		let truncated = false;
+		let fd;
+		try {
+			fd = fs.openSync(filePath, "r");
+		} catch {
+			return null;
+		}
+		try {
+			const bytesRead = fs.readSync(fd, frontmatterBuffer, 0, FRONTMATTER_READ_LIMIT, 0);
+			region = frontmatterBuffer.toString("utf8", 0, bytesRead);
+			truncated = bytesRead === FRONTMATTER_READ_LIMIT && !/\r?\n---/.test(region.slice(3));
+		} finally {
+			fs.closeSync(fd);
+		}
+		if (!truncated) return region;
+	}
 	try {
-		return parse(match[1]);
+		return fs.readFileSync(filePath, "utf8");
 	} catch {
 		return null;
 	}
 }
 
 //#endregion
-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 };
+export { listNestedNodeModulesPackageDirs as a, parseFrontmatter as c, getDeps as i, resolveDepDir as l, detectGlobalNodeModules as n, listNodeModulesPackageDirs as o, findSkillFiles as r, nodeReadFs as s, createFsIdentityCache as t, toPosixPath as u };

package/dist/utils-CSPzvaFu.mjs

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

package/dist/{validate-D0n-rBpp.mjs → validate-CEhp9gDs.mjs}

@@ -1,8 +1,8 @@
-import "./utils-CF7OL__5.mjs";
-import { n as findWorkspacePackages } from "./workspace-patterns-FljtM2Xb.mjs";
-import { t as resolveProjectContext } from "./project-context-4wzbLY9c.mjs";
+import "./utils-9fhWAVua.mjs";
+import { n as findWorkspacePackages } from "./workspace-patterns-BffPlZ1D.mjs";
+import { t as resolveProjectContext } from "./project-context-BRIMzhi4.mjs";
 import { n as isCliFailure, t as fail } from "./cli-error-BrMXlbtx.mjs";
-import { l as printWarnings } from "./cli-support-C-t4xQw0.mjs";
+import { l as printWarnings } from "./cli-support-BNDR3l1g.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-DTvYXAsM.mjs")]);
+	const [{ parse: parseYaml }, { findSkillFiles }] = await Promise.all([import("yaml"), import("./utils-CSPzvaFu.mjs")]);
 	const context = resolveProjectContext({
 		cwd: process.cwd(),
 		targetPath: dir

package/dist/{workspace-patterns-FljtM2Xb.mjs → workspace-patterns-BffPlZ1D.mjs}

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

package/dist/{workspace-patterns-CnGMcicG.mjs → workspace-patterns-Bjq_cXww.mjs}

@@ -1,4 +1,4 @@
-import "./utils-CF7OL__5.mjs";
-import { a as readWorkspacePatterns, i as getWorkspaceInfo, n as findWorkspacePackages, o as resolveWorkspacePackages, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-FljtM2Xb.mjs";
+import "./utils-9fhWAVua.mjs";
+import { a as readWorkspacePatterns, i as getWorkspaceInfo, n as findWorkspacePackages, o as resolveWorkspacePackages, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-BffPlZ1D.mjs";
 
 export { findWorkspaceRoot, getWorkspaceInfo };

package/package.json

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

package/dist/scanner-BK8rIEA3.mjs

@@ -1,6 +0,0 @@
-import "./utils-CF7OL__5.mjs";
-import "./skill-paths-Cc0-Y331.mjs";
-import { n as scanIntentPackageAtRoot, t as scanForIntents } from "./scanner-QujEINYm.mjs";
-import "./workspace-patterns-FljtM2Xb.mjs";
-
-export { scanForIntents };

package/dist/utils-DTvYXAsM.mjs

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