@tanstack/intent 0.2.1 → 0.3.1

package/dist/{scanner-C5bzzri5.mjs → scanner-B1pcLFee.mjs}

@@ -1,11 +1,74 @@
-import { a as listNestedNodeModulesPackageDirs, c as parseFrontmatter, d as toPosixPath, i as getDeps, l as readScalarField, n as detectGlobalNodeModules, o as listNodeModulesPackageDirs, r as findSkillFiles, s as nodeReadFs, t as createFsIdentityCache, u as resolveDepDir } from "./utils-6FtqhOYf.mjs";
-import { r as rewriteSkillLoadPaths } from "./skill-paths-Bm1P6IYe.mjs";
-import { n as findWorkspacePackages, r as findWorkspaceRoot } from "./workspace-patterns-BDoJIWk-.mjs";
-import { t as detectPackageManager } from "./package-manager-Dw7lYcI0.mjs";
+import { a as listNestedNodeModulesPackageDirs, c as parseFrontmatter, d as toPosixPath, i as getDeps, l as readScalarField, n as detectGlobalNodeModules, o as listNodeModulesPackageDirs, r as findSkillFiles, s as nodeReadFs, t as createFsIdentityCache, u as resolveDepDir } from "./utils-Bw7HwOo5.mjs";
+import { n as findWorkspacePackages, r as findWorkspaceRoot } from "./workspace-patterns-hW0v_meY.mjs";
+import { t as detectPackageManager } from "./package-manager-C63Zi9q1.mjs";
+import { r as rewriteSkillLoadPaths } from "./paths-B0KW7rmz.mjs";
 import { createRequire } from "node:module";
 import { existsSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import semver from "semver";
+//#region src/discovery/fs-cache.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function createIntentFsCache() {
+	const packageJsonCache = /* @__PURE__ */ new Map();
+	const skillFilesCache = /* @__PURE__ */ new Map();
+	let activeFs = nodeReadFs;
+	const getFsIdentity = createFsIdentityCache(() => activeFs);
+	const stats = {
+		packageJsonReadCount: 0,
+		packageJsonCacheHits: 0
+	};
+	function readPackageJsonResult(dir) {
+		const key = getFsIdentity(dir);
+		const cached = packageJsonCache.get(key);
+		if (cached) {
+			stats.packageJsonCacheHits += 1;
+			return cached;
+		}
+		stats.packageJsonReadCount += 1;
+		try {
+			const parsed = JSON.parse(activeFs.readFileSync(join(dir, "package.json"), "utf8"));
+			const result = {
+				packageJson: isRecord(parsed) ? parsed : null,
+				error: null
+			};
+			packageJsonCache.set(key, result);
+			return result;
+		} catch (error) {
+			const result = {
+				packageJson: null,
+				error
+			};
+			packageJsonCache.set(key, result);
+			return result;
+		}
+	}
+	function readPackageJson(dir) {
+		return readPackageJsonResult(dir).packageJson;
+	}
+	function findSkillFiles$1(dir) {
+		const key = getFsIdentity(dir);
+		const cached = skillFilesCache.get(key);
+		if (cached) return [...cached];
+		const files = findSkillFiles(dir, activeFs);
+		skillFilesCache.set(key, files);
+		return [...files];
+	}
+	return {
+		readPackageJson,
+		readPackageJsonResult,
+		findSkillFiles: findSkillFiles$1,
+		getFsIdentity,
+		getStats: () => ({ ...stats }),
+		useFs: (fs) => {
+			activeFs = fs;
+		},
+		getReadFs: () => activeFs,
+		exists: (path) => activeFs.existsSync(path)
+	};
+}
+//#endregion
 //#region src/discovery/register.ts
 function isLocalToProject(dirPath, projectRoot) {
 	return dirPath.startsWith(projectRoot + sep) || dirPath.startsWith(projectRoot + "/");
@@ -156,70 +219,7 @@ function createDependencyWalker(opts) {
 	};
 }
 //#endregion
-//#region src/fs-cache.ts
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function createIntentFsCache() {
-	const packageJsonCache = /* @__PURE__ */ new Map();
-	const skillFilesCache = /* @__PURE__ */ new Map();
-	let activeFs = nodeReadFs;
-	const getFsIdentity = createFsIdentityCache(() => activeFs);
-	const stats = {
-		packageJsonReadCount: 0,
-		packageJsonCacheHits: 0
-	};
-	function readPackageJsonResult(dir) {
-		const key = getFsIdentity(dir);
-		const cached = packageJsonCache.get(key);
-		if (cached) {
-			stats.packageJsonCacheHits += 1;
-			return cached;
-		}
-		stats.packageJsonReadCount += 1;
-		try {
-			const parsed = JSON.parse(activeFs.readFileSync(join(dir, "package.json"), "utf8"));
-			const result = {
-				packageJson: isRecord(parsed) ? parsed : null,
-				error: null
-			};
-			packageJsonCache.set(key, result);
-			return result;
-		} catch (error) {
-			const result = {
-				packageJson: null,
-				error
-			};
-			packageJsonCache.set(key, result);
-			return result;
-		}
-	}
-	function readPackageJson(dir) {
-		return readPackageJsonResult(dir).packageJson;
-	}
-	function findSkillFiles$1(dir) {
-		const key = getFsIdentity(dir);
-		const cached = skillFilesCache.get(key);
-		if (cached) return [...cached];
-		const files = findSkillFiles(dir, activeFs);
-		skillFilesCache.set(key, files);
-		return [...files];
-	}
-	return {
-		readPackageJson,
-		readPackageJsonResult,
-		findSkillFiles: findSkillFiles$1,
-		getFsIdentity,
-		getStats: () => ({ ...stats }),
-		useFs: (fs) => {
-			activeFs = fs;
-		},
-		getReadFs: () => activeFs,
-		exists: (path) => activeFs.existsSync(path)
-	};
-}
-//#endregion
-//#region src/scanner.ts
+//#region src/discovery/scanner.ts
 const requireFromHere = createRequire(import.meta.url);
 function findPnpFile(start) {
 	let dir = resolve(start);

package/dist/{setup-Cx1r2y-1.mjs → setup-D5qLjoqf.mjs}

@@ -1,8 +1,8 @@
-import { a as readWorkspacePatterns, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-BDoJIWk-.mjs";
-import { t as resolveProjectContext } from "./project-context-oi_m7paK.mjs";
+import { a as readWorkspacePatterns, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-hW0v_meY.mjs";
+import { t as resolveProjectContext } from "./project-context-CALU5-15.mjs";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { basename, join, relative } from "node:path";
-//#region src/setup.ts
+//#region src/setup/project-setup.ts
 function isGenericWorkspaceName(name, root) {
 	const normalized = name.trim().toLowerCase();
 	return normalized.length === 0 || normalized === "unknown" || normalized === "root" || normalized === "workspace" || normalized === "monorepo" || normalized === basename(root).toLowerCase();
@@ -35,6 +35,12 @@ function detectRepo(pkgJson, fallback) {
 function normalizePattern(pattern) {
 	return pattern.endsWith("**") ? pattern : pattern.replace(/\/$/, "") + "/**";
 }
+function isRemoteUrl(value) {
+	return value.startsWith("http://") || value.startsWith("https://");
+}
+function localDocsPattern(value) {
+	return isRemoteUrl(value) ? null : normalizePattern(value);
+}
 function buildWatchPaths(root, packageDirs) {
 	const paths = /* @__PURE__ */ new Set();
 	if (existsSync(join(root, "docs"))) paths.add("docs/**");
@@ -42,8 +48,8 @@ function buildWatchPaths(root, packageDirs) {
 		const relDir = relative(root, packageDir).split("\\").join("/");
 		if (existsSync(join(packageDir, "src"))) paths.add(`${relDir}/src/**`);
 		const intent = readPackageJson(packageDir).intent;
-		const docs = typeof intent?.docs === "string" ? intent.docs : "docs/";
-		if (!docs.startsWith("http://") && !docs.startsWith("https://")) paths.add(normalizePattern(join(relDir, docs).split("\\").join("/")));
+		const docsPattern = localDocsPattern(typeof intent?.docs === "string" ? intent.docs : "docs/");
+		if (docsPattern) paths.add(normalizePattern(join(relDir, docsPattern).split("\\").join("/")));
 	}
 	if (paths.size === 0) {
 		paths.add("packages/*/src/**");
@@ -62,15 +68,16 @@ function detectVars(root, packageDirs) {
 	const shortName = packageName.replace(/^@[^/]+\//, "");
 	let srcPath = isMonorepo ? "packages/*/src/**" : `packages/${shortName}/src/**`;
 	if (!isMonorepo && existsSync(join(root, "src"))) srcPath = "src/**";
-	const docsPath = isMonorepo ? "packages/*/docs/**" : docs;
+	const docsPath = isMonorepo ? "packages/*/docs/**" : localDocsPattern(docs);
+	const watchPaths = isMonorepo ? buildWatchPaths(root, packageDirs) : [docsPath, srcPath].filter((path) => Boolean(path)).map((path) => `      - '${path}'`).join("\n");
 	return {
 		PACKAGE_NAME: packageName,
 		PACKAGE_LABEL: packageName,
 		PAYLOAD_PACKAGE: packageName,
 		REPO: repo,
-		DOCS_PATH: docsPath.endsWith("**") ? docsPath : docsPath.replace(/\/$/, "") + "/**",
+		DOCS_PATH: docsPath ?? "docs/**",
 		SRC_PATH: srcPath,
-		WATCH_PATHS: isMonorepo ? buildWatchPaths(root, packageDirs) : `      - '${docs.endsWith("**") ? docs : docs.replace(/\/$/, "") + "/**"}'\n      - '${srcPath}'`
+		WATCH_PATHS: watchPaths
 	};
 }
 function applyVars(content, vars) {
@@ -92,7 +99,7 @@ function copyTemplates(srcDir, destDir, vars) {
 			continue;
 		}
 		let content = readFileSync(srcPath, "utf8");
-		if (vars.WATCH_PATHS.includes("\n")) content = content.replace(/\s+- '?\{\{DOCS_PATH\}\}'?\n\s+- '?\{\{SRC_PATH\}\}'?/, vars.WATCH_PATHS);
+		if (vars.WATCH_PATHS) content = content.replace(/\s+- '?\{\{DOCS_PATH\}\}'?\n\s+- '?\{\{SRC_PATH\}\}'?/, vars.WATCH_PATHS);
 		writeFileSync(destPath, applyVars(content, vars));
 		copied.push(destPath);
 	}

package/dist/setup-DFajGERl.mjs

@@ -0,0 +1,3 @@
+import "./workspace-patterns-hW0v_meY.mjs";
+import { n as runEditPackageJsonAll, r as runSetupGithubActions } from "./setup-D5qLjoqf.mjs";
+export { runEditPackageJsonAll, runSetupGithubActions };

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-CdfBc7Oe.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 "./project-setup-Bvmg5uYy.mjs";
 export { EditPackageJsonResult, MonorepoResult, SetupGithubActionsResult, findPackagesWithSkills, findWorkspaceRoot, readWorkspacePatterns, resolveWorkspacePackages, runEditPackageJson, runEditPackageJsonAll, runSetupGithubActions };

package/dist/setup.mjs

@@ -1,3 +1,3 @@
-import { a as readWorkspacePatterns, o as resolveWorkspacePackages, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-BDoJIWk-.mjs";
-import { n as runEditPackageJsonAll, r as runSetupGithubActions, t as runEditPackageJson } from "./setup-Cx1r2y-1.mjs";
+import { a as readWorkspacePatterns, o as resolveWorkspacePackages, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-hW0v_meY.mjs";
+import { n as runEditPackageJsonAll, r as runSetupGithubActions, t as runEditPackageJson } from "./setup-D5qLjoqf.mjs";
 export { findPackagesWithSkills, findWorkspaceRoot, readWorkspacePatterns, resolveWorkspacePackages, runEditPackageJson, runEditPackageJsonAll, runSetupGithubActions };

package/dist/source-policy-C5S58Cno.mjs

@@ -0,0 +1,2 @@
+import { s as scanForPolicedIntents } from "./source-policy-CzZqrSTS.mjs";
+export { scanForPolicedIntents };

package/dist/{source-policy-D__bcpoU.mjs → source-policy-CzZqrSTS.mjs}

@@ -1,6 +1,16 @@
-import { t as scanForIntents } from "./scanner-C5bzzri5.mjs";
-import { t as resolveProjectContext } from "./project-context-oi_m7paK.mjs";
-import { a as isSkillExcluded, i as isPackageExcluded, n as getConfigDirs, o as warningMentionsPackage, r as getEffectiveExcludePatterns, s as readPackageJson, t as compileExcludePatterns } from "./excludes-ByvSbmmj.mjs";
+import { t as scanForIntents } from "./scanner-B1pcLFee.mjs";
+import { t as resolveProjectContext } from "./project-context-CALU5-15.mjs";
+import { a as isSkillExcluded, i as isPackageExcluded, n as getConfigDirs, o as warningMentionsPackage, r as getEffectiveExcludePatterns, s as readPackageJson, t as compileExcludePatterns } from "./excludes-BEi9N7Ys.mjs";
+import { detectAgent, env } from "std-env";
+//#region src/shared/environment.ts
+function detectIntentAudience(explicit) {
+	if (explicit) return explicit;
+	const override = env.INTENT_AUDIENCE?.trim().toLowerCase();
+	if (override === "agent" || override === "human") return override;
+	if (override) throw new Error("Invalid INTENT_AUDIENCE value. Expected \"agent\" or \"human\".");
+	return detectAgent().name ? "agent" : "human";
+}
+//#endregion
 //#region src/core/skill-sources.ts
 var SkillSourcesParseError = class extends Error {
 	constructor(issues) {
@@ -164,13 +174,19 @@ function checkLoadAllowed(use, parsed, params) {
 	};
 	return null;
 }
-function formatUnlistedNotice(names) {
-	const sorted = [...names].sort();
-	const noun = sorted.length === 1 ? "package ships" : "packages ship";
-	return `${sorted.length} discovered ${noun} skills but ${sorted.length === 1 ? "is" : "are"} not listed in intent.skills: ${sorted.join(", ")}. Add to opt in.`;
+function pluralize(count, singular, plural) {
+	return count === 1 ? singular : plural;
+}
+function formatUnlistedNotice(hiddenSources, audience) {
+	const sorted = [...hiddenSources].sort((a, b) => a.name.localeCompare(b.name));
+	const sourceCount = sorted.length;
+	const skillCount = sorted.reduce((sum, source) => sum + source.skillCount, 0);
+	if (audience === "agent") return `${sourceCount} discovered ${pluralize(sourceCount, "skill source", "skill sources")} with ${skillCount} ${pluralize(skillCount, "skill", "skills")} ${pluralize(sourceCount, "is", "are")} hidden because ${pluralize(sourceCount, "it is", "they are")} not listed in intent.skills. Ask the user to run \`intent list --show-hidden\` outside the agent session to review candidates.`;
+	return `${sourceCount} discovered ${sourceCount === 1 ? "package ships" : "packages ship"} skills but ${sourceCount === 1 ? "is" : "are"} not listed in intent.skills: ${sorted.map((source) => source.name).join(", ")}. Add to opt in.`;
 }
 function applySourcePolicy(scanResult, options) {
 	const { config, excludeMatchers } = options;
+	const audience = options.audience ?? "human";
 	const seen = /* @__PURE__ */ new Set();
 	const notices = [];
 	const emit = (notice) => {
@@ -179,11 +195,14 @@ function applySourcePolicy(scanResult, options) {
 		notices.push(notice);
 	};
 	const packages = [];
-	const unlistedNames = [];
+	const hiddenSources = [];
 	for (const pkg of scanResult.packages) {
 		if (isPackageExcluded(pkg.name, excludeMatchers)) continue;
 		if (!isSourcePermitted(config, pkg.name)) {
-			if (config.mode === "explicit") unlistedNames.push(pkg.name);
+			if (config.mode === "explicit") hiddenSources.push({
+				name: pkg.name,
+				skillCount: pkg.skills.length
+			});
 			continue;
 		}
 		const skills = pkg.skills.filter((skill) => !isSkillExcluded(pkg.name, skill.name, excludeMatchers));
@@ -192,7 +211,7 @@ function applySourcePolicy(scanResult, options) {
 			skills
 		});
 	}
-	if (unlistedNames.length > 0) emit(formatUnlistedNotice(unlistedNames));
+	if (hiddenSources.length > 0) emit(formatUnlistedNotice(hiddenSources, audience));
 	if (config.mode === "explicit") {
 		const discoveredNames = new Set(scanResult.packages.map((pkg) => pkg.name));
 		for (const source of config.sources) if (!discoveredNames.has(source.id)) emit(`"${source.raw}" is declared in intent.skills but was not discovered.`);
@@ -201,6 +220,8 @@ function applySourcePolicy(scanResult, options) {
 	else if (config.mode === "allow-all") emit(ALLOW_ALL_NOTICE);
 	else if (config.mode === "empty") emit(EMPTY_NOTE);
 	return {
+		hiddenSourceCount: hiddenSources.length,
+		hiddenSources,
 		packages,
 		notices
 	};
@@ -220,16 +241,20 @@ function readSkillSourcesConfig(cwd, context = resolveProjectContext({ cwd })) {
 function scanForPolicedIntents(params) {
 	const { cwd, scanOptions, coreOptions } = params;
 	const context = params.context ?? resolveProjectContext({ cwd });
+	const audience = detectIntentAudience(coreOptions.audience);
 	const scanResult = scanForIntents(cwd, scanOptions);
 	const config = readSkillSourcesConfig(cwd, context);
 	const excludePatterns = getEffectiveExcludePatterns(coreOptions, context);
 	const policy = applySourcePolicy(scanResult, {
+		audience,
 		config,
 		excludeMatchers: compileExcludePatterns(excludePatterns)
 	});
 	const survivingNames = new Set(policy.packages.map((pkg) => pkg.name));
 	const droppedNames = scanResult.packages.map((pkg) => pkg.name).filter((name) => !survivingNames.has(name));
 	return {
+		hiddenSourceCount: policy.hiddenSourceCount,
+		hiddenSources: audience === "agent" ? [] : policy.hiddenSources,
 		scan: {
 			...scanResult,
 			packages: policy.packages,
@@ -241,4 +266,4 @@ function scanForPolicedIntents(params) {
 	};
 }
 //#endregion
-export { checkLoadAllowed as a, applySourcePolicy as i, EMPTY_NOTE as n, readSkillSourcesConfig as o, MIGRATION_NOTICE as r, scanForPolicedIntents as s, ALLOW_ALL_NOTICE as t };
+export { checkLoadAllowed as a, detectIntentAudience as c, applySourcePolicy as i, EMPTY_NOTE as n, readSkillSourcesConfig as o, MIGRATION_NOTICE as r, scanForPolicedIntents as s, ALLOW_ALL_NOTICE as t };

package/dist/{stale-DhjSTIt-.mjs → stale-DlNJHwga.mjs}

@@ -1,4 +1,4 @@
-import { n as isCliFailure } from "./cli-error-DDAO6DIL.mjs";
+import { n as isCliFailure } from "./cli-error-BebkXaTJ.mjs";
 //#region src/commands/stale.ts
 async function runStaleCommand(targetDir, options, resolveStaleTargets) {
 	if (options.githubReview) {
@@ -34,7 +34,7 @@ async function runStaleCommand(targetDir, options, resolveStaleTargets) {
 	}
 }
 async function runGithubReview(targetDir, options, resolveStaleTargets) {
-	const { collectStaleReviewItems, createFailedStaleReviewItem, createWorkflowAdvisoryReviewItems, writeStaleReviewWorkflowFiles } = await import("./workflow-review-Bo2kPVXV.mjs");
+	const { collectStaleReviewItems, createFailedStaleReviewItem, createWorkflowAdvisoryReviewItems, writeStaleReviewWorkflowFiles } = await import("./workflow-review-Bx8x6_uF.mjs");
 	const packageLabel = options.packageLabel ?? "workspace";
 	try {
 		const { reports, workflowAdvisories = [] } = await resolveStaleTargets(targetDir);

package/dist/{staleness-DoZU3lzy.mjs → staleness-I_jAT1Ge.mjs}

@@ -1,9 +1,9 @@
-import { c as parseFrontmatter, d as toPosixPath, l as readScalarField, r as findSkillFiles } from "./utils-6FtqhOYf.mjs";
-import { t as readIntentArtifacts } from "./artifact-coverage-DFtI6V_H.mjs";
+import { c as parseFrontmatter, d as toPosixPath, l as readScalarField, r as findSkillFiles } from "./utils-Bw7HwOo5.mjs";
+import { t as readIntentArtifacts } from "./artifact-coverage-DerRKsWw.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { isAbsolute, join, relative, resolve } from "node:path";
 import semver from "semver";
-//#region src/staleness.ts
+//#region src/staleness/check.ts
 function classifyVersionDrift(oldVer, newVer) {
 	const oldVersion = normalizeVersion(oldVer);
 	const newVersion = normalizeVersion(newVer);

package/dist/{staleness-B5Cqe77_.mjs → staleness-bEZ8BeGq.mjs}

@@ -1,2 +1,2 @@
-import { n as checkStaleness, r as readPackageName, t as buildWorkspaceCoverageSignals } from "./staleness-DoZU3lzy.mjs";
+import { n as checkStaleness, r as readPackageName, t as buildWorkspaceCoverageSignals } from "./staleness-I_jAT1Ge.mjs";
 export { buildWorkspaceCoverageSignals, checkStaleness, readPackageName };

package/dist/{cli-support-BANzHEBM.mjs → support-CDhR09kb.mjs}

@@ -1,2 +1,2 @@
-import { a as noticeOptionsFromGlobalFlags, c as scanIntentsOrFail, i as getMetaDir, l as printNotices, n as coreOptionsFromGlobalFlags, o as printDebugInfo, r as getCheckSkillsWorkflowAdvisories, s as resolveStaleTargets, t as INTENT_CHECK_SKILLS_WORKFLOW_VERSION, u as printWarnings } from "./cli-support-z64kSJOO.mjs";
+import { a as noticeOptionsFromGlobalFlags, c as scanIntentsOrFail, i as getMetaDir, l as printNotices, n as coreOptionsFromGlobalFlags, o as printDebugInfo, r as getCheckSkillsWorkflowAdvisories, s as resolveStaleTargets, t as INTENT_CHECK_SKILLS_WORKFLOW_VERSION, u as printWarnings } from "./support-D7lyVf_J.mjs";
 export { INTENT_CHECK_SKILLS_WORKFLOW_VERSION, coreOptionsFromGlobalFlags, getCheckSkillsWorkflowAdvisories, getMetaDir, noticeOptionsFromGlobalFlags, printDebugInfo, printNotices, printWarnings, resolveStaleTargets, scanIntentsOrFail };

package/dist/{cli-support-z64kSJOO.mjs → support-D7lyVf_J.mjs}

@@ -1,9 +1,9 @@
-import { t as resolveProjectContext } from "./project-context-oi_m7paK.mjs";
-import { t as fail } from "./cli-error-DDAO6DIL.mjs";
+import { t as resolveProjectContext } from "./project-context-CALU5-15.mjs";
+import { t as fail } from "./cli-error-BebkXaTJ.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-//#region src/cli-output.ts
+//#region src/shared/cli-output.ts
 function printWarnings(warnings) {
 	if (warnings.length === 0) return;
 	console.log("Warnings:");
@@ -29,10 +29,10 @@ function printNotices(notices, options = {}) {
 	for (const notice of notices) console.error(`  ℹ ${notice}`);
 }
 //#endregion
-//#region src/cli-support.ts
+//#region src/commands/support.ts
 const INTENT_CHECK_SKILLS_WORKFLOW_VERSION = 3;
 function getMetaDir() {
-	return join(dirname(fileURLToPath(import.meta.url)), "..", "meta");
+	return join(dirname(fileURLToPath(import.meta.url)), "..", "..", "meta");
 }
 function getCheckSkillsWorkflowAdvisories(root) {
 	const workflowPath = join(root, ".github", "workflows", "check-skills.yml");
@@ -48,7 +48,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(coreOptions = {}) {
-	const { scanForPolicedIntents } = await import("./source-policy-CTeI29oF.mjs");
+	const { scanForPolicedIntents } = await import("./source-policy-C5S58Cno.mjs");
 	try {
 		const { scan } = scanForPolicedIntents({
 			cwd: process.cwd(),
@@ -92,18 +92,18 @@ async function resolveStaleTargets(targetDir) {
 		targetPath: targetDir
 	});
 	const workflowAdvisories = getCheckSkillsWorkflowAdvisories(context.workspaceRoot ?? context.packageRoot ?? resolvedRoot);
-	const { buildWorkspaceCoverageSignals, checkStaleness, readPackageName } = await import("./staleness-B5Cqe77_.mjs");
+	const { buildWorkspaceCoverageSignals, checkStaleness, readPackageName } = await import("./staleness-bEZ8BeGq.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-CrL8hAbd.mjs");
+	const { findWorkspaceRoot, getWorkspaceInfo } = await import("./workspace-patterns-qoXkCfEX.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-CXX6wav1.mjs");
+		const { readIntentArtifacts } = await import("./artifact-coverage-Dia0ZRPy.mjs");
 		const artifacts = existsSync(join(workspaceInfo.root, "_artifacts")) ? readIntentArtifacts(workspaceInfo.root) : null;
 		const coverageSignals = buildWorkspaceCoverageSignals({
 			artifactRoot: workspaceInfo.root,

package/dist/{types-ByXUTBJ2.d.mts → types-Bx6-umBo.d.mts}

@@ -1,4 +1,4 @@
-//#region src/types.d.ts
+//#region src/shared/types.d.ts
 interface IntentConfig {
   version: number;
   repo: string;

package/dist/{skill-use-B2xRF1i9.mjs → use-plp2M918.mjs}

@@ -1,4 +1,4 @@
-//#region src/skill-use.ts
+//#region src/skills/use.ts
 var SkillUseParseError = class extends Error {
 	constructor(code, value) {
 		super(formatSkillUseParseErrorMessage(code, value));

package/dist/{utils-BKBDYbCx.mjs → utils-BpmAIjiN.mjs}

@@ -1,2 +1,2 @@
-import { a as listNestedNodeModulesPackageDirs, c as parseFrontmatter, d as toPosixPath, i as getDeps, l as readScalarField, n as detectGlobalNodeModules, o as listNodeModulesPackageDirs, r as findSkillFiles, s as nodeReadFs, t as createFsIdentityCache, u as resolveDepDir } from "./utils-6FtqhOYf.mjs";
+import { a as listNestedNodeModulesPackageDirs, c as parseFrontmatter, d as toPosixPath, i as getDeps, l as readScalarField, n as detectGlobalNodeModules, o as listNodeModulesPackageDirs, r as findSkillFiles, s as nodeReadFs, t as createFsIdentityCache, u as resolveDepDir } from "./utils-Bw7HwOo5.mjs";
 export { createFsIdentityCache, detectGlobalNodeModules, findSkillFiles, getDeps, listNestedNodeModulesPackageDirs, listNodeModulesPackageDirs, nodeReadFs, parseFrontmatter, readScalarField, resolveDepDir, toPosixPath };

package/dist/{utils-6FtqhOYf.mjs → utils-Bw7HwOo5.mjs}

@@ -3,7 +3,7 @@ import { closeSync, existsSync, lstatSync, openSync, readFileSync, readSync, rea
 import { dirname, join, resolve, sep } from "node:path";
 import { execFileSync } from "node:child_process";
 import { parse } from "yaml";
-//#region src/utils.ts
+//#region src/shared/utils.ts
 const nodeReadFs = {
 	existsSync,
 	lstatSync,

package/dist/{validate-BAU0uzvQ.mjs → validate-Cm-gfxGX.mjs}

@@ -1,7 +1,7 @@
-import { n as findWorkspacePackages } from "./workspace-patterns-BDoJIWk-.mjs";
-import { t as resolveProjectContext } from "./project-context-oi_m7paK.mjs";
-import { n as isCliFailure, t as fail } from "./cli-error-DDAO6DIL.mjs";
-import { u as printWarnings } from "./cli-support-z64kSJOO.mjs";
+import { n as findWorkspacePackages } from "./workspace-patterns-hW0v_meY.mjs";
+import { t as resolveProjectContext } from "./project-context-CALU5-15.mjs";
+import { n as isCliFailure, t as fail } from "./cli-error-BebkXaTJ.mjs";
+import { u as printWarnings } from "./support-D7lyVf_J.mjs";
 import { appendFileSync, existsSync, readFileSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, relative, resolve } from "node:path";
 //#region src/commands/validate.ts
@@ -156,7 +156,7 @@ async function runValidateCommand(dir, options = {}) {
 	}
 }
 async function runValidateCommandInternal(dir, options = {}) {
-	const [{ parse: parseYaml }, { findSkillFiles, readScalarField }] = await Promise.all([import("yaml"), import("./utils-BKBDYbCx.mjs")]);
+	const [{ parse: parseYaml }, { findSkillFiles, readScalarField }] = await Promise.all([import("yaml"), import("./utils-BpmAIjiN.mjs")]);
 	const context = resolveProjectContext({
 		cwd: process.cwd(),
 		targetPath: dir

package/dist/{workflow-review-Bo2kPVXV.mjs → workflow-review-Bx8x6_uF.mjs}

@@ -1,2 +1,2 @@
-import { a as writeStaleReviewWorkflowFiles, i as createWorkflowAdvisoryReviewItems, n as collectStaleReviewItems, r as createFailedStaleReviewItem } from "./workflow-review-B4AfwtHH.mjs";
+import { a as writeStaleReviewWorkflowFiles, i as createWorkflowAdvisoryReviewItems, n as collectStaleReviewItems, r as createFailedStaleReviewItem } from "./workflow-review-CEwwmDdD.mjs";
 export { collectStaleReviewItems, createFailedStaleReviewItem, createWorkflowAdvisoryReviewItems, writeStaleReviewWorkflowFiles };

package/dist/{workflow-review-B4AfwtHH.mjs → workflow-review-CEwwmDdD.mjs}

@@ -1,5 +1,5 @@
 import { appendFileSync, writeFileSync } from "node:fs";
-//#region src/workflow-review.ts
+//#region src/staleness/workflow-review.ts
 function collectStaleReviewItems(reports) {
 	const items = [];
 	for (const report of reports) {

package/dist/{workspace-patterns-BDoJIWk-.mjs → workspace-patterns-hW0v_meY.mjs}

@@ -1,9 +1,9 @@
-import { r as findSkillFiles } from "./utils-6FtqhOYf.mjs";
+import { r as findSkillFiles } from "./utils-Bw7HwOo5.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { parse } from "yaml";
 import { parse as parse$1 } from "jsonc-parser";
-//#region src/workspace-patterns.ts
+//#region src/setup/workspace-patterns.ts
 function normalizeWorkspacePattern(pattern) {
 	return pattern.replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+$/, "");
 }

package/dist/{workspace-patterns-CrL8hAbd.mjs → workspace-patterns-qoXkCfEX.mjs}

@@ -1,2 +1,2 @@
-import { i as getWorkspaceInfo, r as findWorkspaceRoot } from "./workspace-patterns-BDoJIWk-.mjs";
+import { i as getWorkspaceInfo, r as findWorkspaceRoot } from "./workspace-patterns-hW0v_meY.mjs";
 export { findWorkspaceRoot, getWorkspaceInfo };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/intent",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Ship compositional knowledge for AI coding agents alongside your npm packages",
   "license": "MIT",
   "type": "module",
@@ -29,6 +29,7 @@
     "cac": "^6.7.14",
     "jsonc-parser": "^3.3.1",
     "semver": "^7.8.4",
+    "std-env": "^4.1.0",
     "yaml": "2.9.0"
   },
   "devDependencies": {

package/dist/artifact-coverage-CXX6wav1.mjs

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

package/dist/source-policy-CTeI29oF.mjs

@@ -1,2 +0,0 @@
-import { s as scanForPolicedIntents } from "./source-policy-D__bcpoU.mjs";
-export { scanForPolicedIntents };