@tanstack/intent 0.0.36 → 0.0.38

package/dist/scaffold-D2vwv9ls.mjs

@@ -0,0 +1,75 @@
+import { join } from "node:path";
+
+//#region src/commands/scaffold.ts
+function runScaffoldCommand(metaDir) {
+	function metaSkillPath(name) {
+		return join(metaDir, name, "SKILL.md");
+	}
+	const prompt = `You are helping a library maintainer scaffold Intent skills.
+
+Run the three meta skills below **one at a time, in order**. For each step:
+1. Load the SKILL.md file specified
+2. Follow its instructions completely
+3. Present outputs to the maintainer for review
+4. Do NOT proceed to the next step until the maintainer confirms
+
+## Before you start
+
+Gather this context yourself (do not ask the maintainer — agents should never
+ask for information they can discover):
+1. Read package.json for library name, repository URL, and homepage/docs URL
+2. Detect if this is a monorepo (look for workspaces field, packages/ directory, lerna.json)
+3. Use skills/ as the default skills root
+4. For monorepos:
+   - Domain map artifacts go at the REPO ROOT: _artifacts/
+   - Skills go INSIDE EACH PACKAGE: packages/<pkg>/skills/
+   - Identify which packages are client-facing (usually client SDKs and primary framework adapters)
+
+---
+
+## Step 1 — Domain Discovery
+
+Load and follow: ${metaSkillPath("domain-discovery")}
+
+This produces: domain_map.yaml and skill_spec.md in the artifacts directory.
+Domain discovery covers the WHOLE library (one domain map even for monorepos).
+
+**STOP. Review outputs with the maintainer before continuing.**
+
+---
+
+## Step 2 — Tree Generator
+
+Load and follow: ${metaSkillPath("tree-generator")}
+
+This produces: skill_tree.yaml in the artifacts directory.
+For monorepos, each skill entry should include a \`package\` field.
+
+**STOP. Review outputs with the maintainer before continuing.**
+
+---
+
+## Step 3 — Generate Skills
+
+Load and follow: ${metaSkillPath("generate-skill")}
+
+This produces: individual SKILL.md files.
+- Single-repo: skills/<domain>/<skill>/SKILL.md
+- Monorepo: packages/<pkg>/skills/<domain>/<skill>/SKILL.md
+
+---
+
+## After all skills are generated
+
+1. Run \`intent validate\` in each package directory
+2. Commit skills/ and artifacts
+3. For each publishable package, run: \`npx @tanstack/intent edit-package-json\`
+4. Ensure each package has \`@tanstack/intent\` as a devDependency
+5. Create a \`skill:<skill-name>\` label on the GitHub repo for each skill (use \`gh label create\`)
+6. Add a README note: "If you use an AI agent, run \`npx @tanstack/intent@latest install\`"
+`;
+	console.log(prompt);
+}
+
+//#endregion
+export { runScaffoldCommand };

package/dist/scanner-ByG70-E3.mjs

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

package/dist/{scanner-B1j-wDhj.mjs → scanner-DwYsjXzI.mjs}

@@ -1,9 +1,9 @@
-import { a as parseFrontmatter, i as listNodeModulesPackageDirs, o as resolveDepDir, r as getDeps, s as toPosixPath, t as detectGlobalNodeModules } from "./utils-COlDcU72.mjs";
-import { r as rewriteSkillLoadPaths } from "./skill-paths-8k9K9y26.mjs";
-import { a as resolveWorkspacePackages, i as readWorkspacePatterns, r as findWorkspaceRoot } from "./workspace-patterns-BN2A_60g.mjs";
+import { a as parseFrontmatter, i as listNodeModulesPackageDirs, o as resolveDepDir, r as getDeps, s as toPosixPath, t as detectGlobalNodeModules } from "./utils-mdb4i6VA.mjs";
+import { r as rewriteSkillLoadPaths } from "./skill-paths-DNOHrvL5.mjs";
+import { a as readWorkspacePatterns, o as resolveWorkspacePackages, r as findWorkspaceRoot } from "./workspace-patterns-BZLEaMcS.mjs";
 import { createRequire } from "node:module";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
-import { dirname, join, relative, resolve, sep } from "node:path";
+import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 
 //#region src/discovery/register.ts
 function isLocalToProject(dirPath, projectRoot) {
@@ -232,7 +232,35 @@ function deriveIntentConfig(pkgJson) {
 		requires
 	};
 }
-function discoverSkills(skillsDir, _baseName) {
+function readSkillEntry(skillsDir, childDir, skillFile) {
+	const fm = parseFrontmatter(skillFile);
+	const relName = toPosixPath(relative(skillsDir, childDir));
+	const desc = typeof fm?.description === "string" ? fm.description.replace(/\s+/g, " ").trim() : "";
+	return {
+		name: typeof fm?.name === "string" ? fm.name : relName,
+		path: skillFile,
+		description: desc,
+		type: typeof fm?.type === "string" ? fm.type : void 0,
+		framework: typeof fm?.framework === "string" ? fm.framework : void 0
+	};
+}
+function discoverSkillByNameHint(skillsDir, packageName, skillNameHint) {
+	const skills = [];
+	const seen = /* @__PURE__ */ new Set();
+	const skillNameHints = getSkillNameHints(packageName, skillNameHint);
+	for (const hint of skillNameHints) {
+		const resolvedHint = resolveSkillNameHintPath(skillsDir, hint);
+		if (!resolvedHint) continue;
+		const { childDir, skillFile } = resolvedHint;
+		if (!existsSync(skillFile)) continue;
+		const skill = readSkillEntry(skillsDir, childDir, skillFile);
+		if (skill.name !== hint || seen.has(skill.name)) continue;
+		seen.add(skill.name);
+		skills.push(skill);
+	}
+	return skills;
+}
+function discoverSkills(skillsDir) {
 	const skills = [];
 	function walk(dir) {
 		let entries;
@@ -248,24 +276,37 @@ function discoverSkills(skillsDir, _baseName) {
 			if (!entry.isDirectory()) continue;
 			const childDir = join(dir, entry.name);
 			const skillFile = join(childDir, "SKILL.md");
-			if (existsSync(skillFile)) {
-				const fm = parseFrontmatter(skillFile);
-				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,
-					path: skillFile,
-					description: desc,
-					type: typeof fm?.type === "string" ? fm.type : void 0,
-					framework: typeof fm?.framework === "string" ? fm.framework : void 0
-				});
-			}
+			if (existsSync(skillFile)) skills.push(readSkillEntry(skillsDir, childDir, skillFile));
 			walk(childDir);
 		}
 	}
 	walk(skillsDir);
 	return skills;
 }
+function getPackageShortName(packageName) {
+	return packageName.split("/").pop() ?? packageName;
+}
+function isWithinOrEqual(path, parentDir) {
+	const rel = relative(parentDir, path);
+	return rel === "" || !rel.startsWith("..") && !isAbsolute(rel);
+}
+function resolveSkillNameHintPath(skillsDir, hint) {
+	if (hint.startsWith("/") || hint.startsWith("\\")) return null;
+	const parts = hint.split("/");
+	if (parts.some((part) => part === "" || part === "." || part === ".." || part.includes("\\"))) return null;
+	const resolvedSkillsDir = resolve(skillsDir);
+	const childDir = resolve(resolvedSkillsDir, ...parts);
+	if (!isWithinOrEqual(childDir, resolvedSkillsDir)) return null;
+	return {
+		childDir,
+		skillFile: join(childDir, "SKILL.md")
+	};
+}
+function getSkillNameHints(packageName, skillNameHint) {
+	const packageShortName = getPackageShortName(packageName);
+	if (skillNameHint.startsWith(`${packageShortName}/`)) return [skillNameHint];
+	return [skillNameHint, `${packageShortName}/${skillNameHint}`];
+}
 function topoSort(packages) {
 	const byName = new Map(packages.map((p) => [p.name, p]));
 	const visited = /* @__PURE__ */ new Set();
@@ -460,10 +501,15 @@ function scanForIntents(root, options = {}) {
 			}
 		}
 		assertLocalNodeModulesSupported(projectRoot);
-		scanTarget(nodeModules.local);
 		walkWorkspacePackages();
+		const packageCountBeforeDependencyDiscovery = packages.length;
+		scanTarget(nodeModules.local);
 		walkKnownPackages();
 		walkProjectDeps();
+		if (packages.length === packageCountBeforeDependencyDiscovery) {
+			const api = getPnpApi();
+			if (api) scanPnpPackages(api);
+		}
 	}
 	function scanGlobalPackages() {
 		ensureGlobalNodeModules();
@@ -506,6 +552,42 @@ function scanForIntents(root, options = {}) {
 		nodeModules
 	};
 }
+function scanIntentPackageAtRoot(packageRoot, options = {}) {
+	const projectRoot = options.projectRoot ?? packageRoot;
+	const packages = [];
+	const warnings = [];
+	const packageIndexes = /* @__PURE__ */ new Map();
+	const packageJsonCache = /* @__PURE__ */ new Map();
+	function readPkgJson(dirPath) {
+		if (packageJsonCache.has(dirPath)) return packageJsonCache.get(dirPath) ?? null;
+		try {
+			const pkgJson = JSON.parse(readFileSync(join(dirPath, "package.json"), "utf8"));
+			packageJsonCache.set(dirPath, pkgJson);
+			return pkgJson;
+		} catch {
+			packageJsonCache.set(dirPath, null);
+			return null;
+		}
+	}
+	const { tryRegister } = createPackageRegistrar({
+		comparePackageVersions,
+		deriveIntentConfig,
+		discoverSkills: options.skillNameHint ? (skillsDir, packageName) => discoverSkillByNameHint(skillsDir, packageName, options.skillNameHint) : discoverSkills,
+		getPackageDepth,
+		packageIndexes,
+		packages,
+		projectRoot,
+		readPkgJson,
+		rememberVariant() {},
+		validateIntentField,
+		warnings
+	});
+	tryRegister(packageRoot, options.fallbackName ?? "unknown", options.source ?? "local");
+	return {
+		package: packages[0] ?? null,
+		warnings
+	};
+}
 
 //#endregion
-export { scanForIntents as t };
+export { scanIntentPackageAtRoot as n, scanForIntents as t };

package/dist/{setup-t1i2o2-h.d.mts → setup-2SE9zYJk.d.mts}

@@ -1,4 +1,5 @@
 //#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;

package/dist/setup-github-actions-emXSyGy3.mjs

@@ -0,0 +1,8 @@
+//#region src/commands/setup-github-actions.ts
+async function runSetupGithubActionsCommand(root, metaDir) {
+	const { runSetupGithubActions } = await import("./setup.mjs");
+	runSetupGithubActions(root, metaDir);
+}
+
+//#endregion
+export { runSetupGithubActionsCommand };

package/dist/{setup-Dp-W8y0Y.mjs → setup-kvWN4xCr.mjs}

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

package/dist/setup.d.mts

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

package/dist/setup.mjs

@@ -1,6 +1,6 @@
-import "./utils-COlDcU72.mjs";
-import { a as resolveWorkspacePackages, i as readWorkspacePatterns, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-BN2A_60g.mjs";
-import "./project-context-alYMNoNa.mjs";
-import { n as runEditPackageJsonAll, r as runSetupGithubActions, t as runEditPackageJson } from "./setup-Dp-W8y0Y.mjs";
+import "./utils-mdb4i6VA.mjs";
+import { a as readWorkspacePatterns, o as resolveWorkspacePackages, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-BZLEaMcS.mjs";
+import "./project-context-Dx6XIJJo.mjs";
+import { n as runEditPackageJsonAll, r as runSetupGithubActions, t as runEditPackageJson } from "./setup-kvWN4xCr.mjs";
 
 export { findPackagesWithSkills, findWorkspaceRoot, readWorkspacePatterns, resolveWorkspacePackages, runEditPackageJson, runEditPackageJsonAll, runSetupGithubActions };

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

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

package/dist/stale-flPZnWfI.mjs

@@ -0,0 +1,53 @@
+//#region src/commands/stale.ts
+async function runStaleCommand(targetDir, options, resolveStaleTargets) {
+	if (options.githubReview) {
+		await runGithubReview(targetDir, options, resolveStaleTargets);
+		return;
+	}
+	const { reports, workflowAdvisories = [] } = await resolveStaleTargets(targetDir);
+	if (options.json) {
+		console.log(JSON.stringify(reports, null, 2));
+		return;
+	}
+	for (const advisory of workflowAdvisories) console.log(advisory);
+	if (workflowAdvisories.length > 0) console.log();
+	if (reports.length === 0) {
+		console.log("No intent-enabled packages found.");
+		return;
+	}
+	for (const report of reports) {
+		const driftLabel = report.versionDrift ? ` [${report.versionDrift} drift]` : "";
+		const vLabel = report.skillVersion && report.currentVersion ? ` (${report.skillVersion} → ${report.currentVersion})` : "";
+		console.log(`${report.library}${vLabel}${driftLabel}`);
+		const stale = report.skills.filter((skill) => skill.needsReview);
+		const signals = report.signals.filter((signal) => signal.needsReview);
+		if (stale.length === 0 && signals.length === 0) console.log("  All skills up-to-date");
+		else {
+			for (const skill of stale) console.log(`  ⚠ ${skill.name}: ${skill.reasons.join(", ")}`);
+			for (const signal of signals) {
+				const subject = signal.packageName ?? signal.packageRoot ?? signal.skill ?? signal.artifactPath ?? signal.subject ?? report.library;
+				console.log(`  ⚠ ${subject}: ${signal.reasons.join(", ")}`);
+			}
+		}
+		console.log();
+	}
+}
+async function runGithubReview(targetDir, options, resolveStaleTargets) {
+	const { collectStaleReviewItems, createFailedStaleReviewItem, createWorkflowAdvisoryReviewItems, writeStaleReviewWorkflowFiles } = await import("./workflow-review-CIdJXmKP.mjs");
+	const packageLabel = options.packageLabel ?? "workspace";
+	try {
+		const { reports, workflowAdvisories = [] } = await resolveStaleTargets(targetDir);
+		const items = [...collectStaleReviewItems(reports), ...createWorkflowAdvisoryReviewItems(packageLabel, workflowAdvisories)];
+		writeStaleReviewWorkflowFiles(items);
+		if (items.length === 0) console.log("No stale skills or coverage gaps found.");
+		else console.log(`Wrote ${items.length} intent skill review item(s).`);
+	} catch (err) {
+		writeStaleReviewWorkflowFiles([createFailedStaleReviewItem(packageLabel)]);
+		const message = err instanceof Error ? err.message : String(err);
+		console.log(`Intent stale check failed: ${message}`);
+		console.log("Wrote a review PR body so maintainers can inspect the logs.");
+	}
+}
+
+//#endregion
+export { runStaleCommand };

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

@@ -1,5 +1,5 @@
-import { a as parseFrontmatter, n as findSkillFiles } from "./utils-COlDcU72.mjs";
-import { t as readIntentArtifacts } from "./artifact-coverage-wLNVX8yC.mjs";
+import { a as parseFrontmatter, n as findSkillFiles } from "./utils-mdb4i6VA.mjs";
+import { t as readIntentArtifacts } from "./artifact-coverage-DgWuVqUp.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { isAbsolute, join, relative, resolve, sep } from "node:path";
 

package/dist/staleness-DpyuNdd5.mjs

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

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

@@ -143,4 +143,4 @@ interface IntentProjectConfig {
   };
 }
 //#endregion
-export { StalenessReport as _, IntentArtifactSet as a, IntentConfig as c, MetaFeedbackPayload as d, MetaSkillName as f, SkillStaleness as g, SkillEntry as h, IntentArtifactFile as i, IntentPackage as l, ScanResult as m, FeedbackPayload as n, IntentArtifactSkill as o, ScanOptions as p, IntentArtifactCoverageIgnore as r, IntentArtifactWarning as s, AgentName as t, IntentProjectConfig as u, StalenessSignal as v, VersionConflict as y };
+export { SkillStaleness as _, IntentArtifactSet as a, VersionConflict as b, IntentConfig as c, MetaFeedbackPayload as d, MetaSkillName as f, SkillEntry as g, ScanScope as h, IntentArtifactFile as i, IntentPackage as l, ScanResult as m, FeedbackPayload as n, IntentArtifactSkill as o, ScanOptions as p, IntentArtifactCoverageIgnore as r, IntentArtifactWarning as s, AgentName as t, IntentProjectConfig as u, StalenessReport as v, StalenessSignal as y };

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

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

package/dist/validate-BL1SYAwh.mjs

@@ -0,0 +1,271 @@
+import "./utils-mdb4i6VA.mjs";
+import { n as findWorkspacePackages } from "./workspace-patterns-BZLEaMcS.mjs";
+import { t as resolveProjectContext } from "./project-context-Dx6XIJJo.mjs";
+import { n as isCliFailure, t as fail } from "./cli-error-BrMXlbtx.mjs";
+import { l as printWarnings } from "./cli-support-BON5hn4L.mjs";
+import { appendFileSync, existsSync, readFileSync } from "node:fs";
+import { basename, dirname, join, relative, resolve, sep } from "node:path";
+
+//#region src/commands/validate.ts
+const agentSkillNamePattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function buildValidationFailure(errors, warnings) {
+	const lines = [
+		"",
+		`❌ Validation failed with ${errors.length} error(s):`,
+		""
+	];
+	for (const { file, message } of errors) lines.push(`  ${file}: ${message}`);
+	if (warnings.length > 0) {
+		lines.push("", "⚠ Packaging warnings:");
+		for (const warning of warnings) lines.push(`  ${warning}`);
+	}
+	return lines.join("\n");
+}
+function collectPackagingWarnings(context) {
+	if (!context.packageRoot || !context.targetPackageJsonPath) return [];
+	const pkgJsonPath = context.targetPackageJsonPath;
+	if (!existsSync(pkgJsonPath)) return [];
+	let pkgJson;
+	try {
+		pkgJson = JSON.parse(readFileSync(pkgJsonPath, "utf8"));
+	} catch (err) {
+		return [`Could not parse package.json: ${err instanceof Error ? err.message : String(err)}`];
+	}
+	const warnings = [];
+	if (!pkgJson.devDependencies?.["@tanstack/intent"]) warnings.push("@tanstack/intent is not in devDependencies");
+	const keywords = pkgJson.keywords;
+	if (!Array.isArray(keywords) || !keywords.includes("tanstack-intent")) warnings.push("Missing \"tanstack-intent\" in keywords array");
+	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 (!context.isMonorepo && !files.includes("!skills/_artifacts")) warnings.push("\"!skills/_artifacts\" is not in the \"files\" array — artifacts will be published unnecessarily");
+	}
+	return warnings;
+}
+function formatWarning({ file, message }) {
+	return `${file}: ${message}`;
+}
+function isRecord(value) {
+	return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function collectAgentSkillSpecWarnings({ filePath, fm, rel }) {
+	const warnings = [];
+	if (typeof fm.name === "string") {
+		if (fm.name.length > 64) warnings.push({
+			file: rel,
+			message: `Agent Skills spec warning: name exceeds 64 characters (${fm.name.length} chars)`
+		});
+		for (const segment of fm.name.split("/")) if (!agentSkillNamePattern.test(segment)) {
+			warnings.push({
+				file: rel,
+				message: "Agent Skills spec warning: each name segment should use lowercase letters, numbers, and single hyphens only"
+			});
+			break;
+		}
+		const parentDir = basename(dirname(filePath));
+		if (!fm.name.includes("/") && fm.name !== parentDir) warnings.push({
+			file: rel,
+			message: "Agent Skills spec warning: name should match the parent directory name"
+		});
+	}
+	if (fm.license !== void 0 && (typeof fm.license !== "string" || fm.license.trim().length === 0)) warnings.push({
+		file: rel,
+		message: "Agent Skills spec warning: license should be a non-empty string"
+	});
+	if (fm.compatibility !== void 0) {
+		if (typeof fm.compatibility !== "string" || fm.compatibility.trim().length === 0) warnings.push({
+			file: rel,
+			message: "Agent Skills spec warning: compatibility should be a non-empty string"
+		});
+		else if (fm.compatibility.length > 500) warnings.push({
+			file: rel,
+			message: `Agent Skills spec warning: compatibility exceeds 500 characters (${fm.compatibility.length} chars)`
+		});
+	}
+	if (fm.metadata !== void 0) {
+		if (!isRecord(fm.metadata)) warnings.push({
+			file: rel,
+			message: "Agent Skills spec warning: metadata should be a mapping"
+		});
+		else if (Object.values(fm.metadata).some((value) => typeof value !== "string")) warnings.push({
+			file: rel,
+			message: "Agent Skills spec warning: metadata values should be strings"
+		});
+	}
+	if (fm["allowed-tools"] !== void 0 && typeof fm["allowed-tools"] !== "string") warnings.push({
+		file: rel,
+		message: "Agent Skills spec warning: allowed-tools should be a space-separated string"
+	});
+	return warnings;
+}
+async function runValidateCommand(dir, options = {}) {
+	if (!options.githubSummary) {
+		await runValidateCommandInternal(dir);
+		return;
+	}
+	try {
+		await runValidateCommandInternal(dir);
+		writeGithubValidationSummary({ ok: true });
+	} catch (err) {
+		writeGithubValidationSummary({
+			ok: false,
+			message: validationErrorMessage(err)
+		});
+		throw err;
+	}
+}
+async function runValidateCommandInternal(dir) {
+	const [{ parse: parseYaml }, { findSkillFiles }] = await Promise.all([import("yaml"), import("./utils-BHzSyNeJ.mjs")]);
+	const context = resolveProjectContext({
+		cwd: process.cwd(),
+		targetPath: dir
+	});
+	const explicitDir = dir !== void 0;
+	const skillsDirs = explicitDir ? [context.targetSkillsDir ?? resolve(process.cwd(), dir)] : collectDefaultSkillsDirs(context, findSkillFiles);
+	if (explicitDir && !existsSync(skillsDirs[0])) fail(`Skills directory not found: ${skillsDirs[0]}`);
+	const errors = [];
+	const warnings = [];
+	let validatedCount = 0;
+	if (explicitDir && findSkillFiles(skillsDirs[0]).length === 0) fail("No SKILL.md files found");
+	if (skillsDirs.length === 0) {
+		console.log("No skills/ directory found — skipping validation.");
+		return;
+	}
+	for (const skillsDir of skillsDirs) {
+		const skillFiles = findSkillFiles(skillsDir);
+		const validateContext = resolveProjectContext({
+			cwd: process.cwd(),
+			targetPath: skillsDir
+		});
+		for (const filePath of skillFiles) {
+			const rel = relative(process.cwd(), filePath);
+			const content = readFileSync(filePath, "utf8");
+			const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)/);
+			if (!match) {
+				errors.push({
+					file: rel,
+					message: "Missing or invalid frontmatter"
+				});
+				continue;
+			}
+			if (!match[1]) {
+				errors.push({
+					file: rel,
+					message: "Missing YAML frontmatter"
+				});
+				continue;
+			}
+			let fm;
+			try {
+				fm = parseYaml(match[1]);
+			} catch (err) {
+				const detail = err instanceof Error ? err.message : String(err);
+				errors.push({
+					file: rel,
+					message: `Invalid YAML frontmatter: ${detail}`
+				});
+				continue;
+			}
+			if (!fm.name) errors.push({
+				file: rel,
+				message: "Missing required field: name"
+			});
+			if (!fm.description) errors.push({
+				file: rel,
+				message: "Missing required field: description"
+			});
+			if (typeof fm.name === "string") {
+				const expectedPath = relative(skillsDir, filePath).replace(/[/\\]SKILL\.md$/, "").split(sep).join("/");
+				if (fm.name !== expectedPath) errors.push({
+					file: rel,
+					message: `name "${fm.name}" does not match directory path "${expectedPath}"`
+				});
+			}
+			if (typeof fm.description === "string" && fm.description.length > 1024) errors.push({
+				file: rel,
+				message: `Description exceeds 1024 character limit (${fm.description.length} chars)`
+			});
+			if (fm.type === "framework" && !Array.isArray(fm.requires)) errors.push({
+				file: rel,
+				message: "Framework skills must have a \"requires\" field"
+			});
+			warnings.push(...collectAgentSkillSpecWarnings({
+				filePath,
+				fm,
+				rel
+			}).map(formatWarning));
+			const lineCount = content.split(/\r?\n/).length;
+			if (lineCount > 500) errors.push({
+				file: rel,
+				message: `Exceeds 500 line limit (${lineCount} lines). Rewrite for conciseness: move API tables to references/, trim verbose examples, and remove content an agent already knows. Do not simply raise the limit.`
+			});
+		}
+		const artifactsDir = join(skillsDir, "_artifacts");
+		if (!validateContext.isMonorepo && existsSync(artifactsDir)) for (const fileName of [
+			"domain_map.yaml",
+			"skill_spec.md",
+			"skill_tree.yaml"
+		]) {
+			const artifactPath = join(artifactsDir, fileName);
+			if (!existsSync(artifactPath)) {
+				errors.push({
+					file: relative(process.cwd(), artifactPath),
+					message: "Missing required artifact"
+				});
+				continue;
+			}
+			const content = readFileSync(artifactPath, "utf8");
+			if (content.trim().length === 0) {
+				errors.push({
+					file: relative(process.cwd(), artifactPath),
+					message: "Artifact file is empty"
+				});
+				continue;
+			}
+			if (fileName.endsWith(".yaml")) try {
+				parseYaml(content);
+			} catch (err) {
+				const detail = err instanceof Error ? err.message : String(err);
+				errors.push({
+					file: relative(process.cwd(), artifactPath),
+					message: `Invalid YAML in artifact file: ${detail}`
+				});
+			}
+		}
+		validatedCount += skillFiles.length;
+		warnings.push(...collectPackagingWarnings(validateContext));
+	}
+	if (errors.length > 0) fail(buildValidationFailure(errors, warnings));
+	console.log(`✅ Validated ${validatedCount} skill files — all passed`);
+	if (warnings.length > 0) console.log();
+	printWarnings(warnings);
+}
+function validationErrorMessage(err) {
+	if (isCliFailure(err)) return err.message;
+	if (err instanceof Error) return err.message;
+	return String(err);
+}
+function writeGithubValidationSummary({ message, ok }) {
+	const summaryPath = process.env.GITHUB_STEP_SUMMARY;
+	if (!summaryPath) return;
+	const lines = ["### Intent skill validation", ""];
+	if (ok) lines.push("Skill validation passed.", "");
+	else lines.push("Skill validation failed.", "", "Why this failed:", "", "Intent validates SKILL.md frontmatter, skill names, required fields, size limits, framework requirements, and artifact files.", "The command output below contains the exact file-level reasons to fix.", "", "Run locally:", "", "```bash", "npx @tanstack/intent@latest validate", "```", "", "Command output:", "", "```text", message ?? "Unknown validation error.", "```", "");
+	appendFileSync(summaryPath, lines.join("\n"));
+}
+function collectDefaultSkillsDirs(context, findSkillFiles) {
+	const skillsDirs = [];
+	const addSkillsDir = (skillsDir) => {
+		if (existsSync(skillsDir) && findSkillFiles(skillsDir).length > 0) skillsDirs.push(skillsDir);
+	};
+	if (context.workspaceRoot && context.cwd === context.workspaceRoot) {
+		addSkillsDir(join(context.workspaceRoot, "skills"));
+		for (const packageDir of findWorkspacePackages(context.workspaceRoot)) addSkillsDir(join(packageDir, "skills"));
+		return [...new Set(skillsDirs)].sort((a, b) => a.localeCompare(b));
+	}
+	addSkillsDir(context.targetSkillsDir ?? (context.packageRoot ? join(context.packageRoot, "skills") : resolve(context.cwd, "skills")));
+	return skillsDirs;
+}
+
+//#endregion
+export { runValidateCommand };

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

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

package/dist/workspace-patterns-BWMz7TsI.mjs

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