@tanstack/intent 0.0.32 → 0.0.33

package/README.md

@@ -90,10 +90,10 @@ npx @tanstack/intent@latest stale
 
 From a monorepo root, `intent stale` checks every workspace package that ships skills. To scope it to one package, pass a directory like `intent stale packages/router`.
 
-Copy CI workflow templates into your repo so validation and staleness checks run on every push:
+Copy CI workflow templates into your repo so validation and staleness checks can run in GitHub Actions:
 
 ```bash
-npx @tanstack/intent@latest setup-github-actions
+npx @tanstack/intent@latest setup
 ```
 
 ## Compatibility
@@ -108,14 +108,14 @@ npx @tanstack/intent@latest setup-github-actions
 
 ## Monorepos
 
-- Run `npx @tanstack/intent@latest setup-github-actions` from either the repo root or a package directory. Intent detects the workspace root and writes workflows to the repo-level `.github/workflows/` directory.
-- Generated workflows are monorepo-aware: validation loops over workspace packages with skills, staleness checks run from the workspace root, and notify workflows watch package `src/` and docs paths.
+- Run `npx @tanstack/intent@latest setup` from either the repo root or a package directory. Intent detects the workspace root and writes workflows to the repo-level `.github/workflows/` directory.
+- Generated workflows are monorepo-aware: validation loops over workspace packages with skills, and staleness checks run from the workspace root.
 - Run `npx @tanstack/intent@latest validate packages/<pkg>/skills` from the repo root to validate one package without root-level packaging warnings.
-- Run `npx @tanstack/intent@latest stale` from the repo root to check all workspace packages with skills, or `intent stale packages/<pkg>` to check one package.
+- Run `npx @tanstack/intent@latest stale` from the repo root to check workspace packages with skills and public workspace packages missing skill or `_artifacts` coverage, or `intent stale packages/<pkg>` to check one package.
 
 ## Keeping skills current
 
-The real risk with any derived artifact is staleness. `npx @tanstack/intent@latest stale` flags skills whose source docs have changed, and CI templates catch drift before it ships.
+The real risk with any derived artifact is staleness. `npx @tanstack/intent@latest stale` flags skills whose source docs have changed, generated skills that drift from `_artifacts`, and public workspace packages missing coverage. CI templates catch drift before it ships.
 
 The feedback loop runs both directions. `npx @tanstack/intent@latest feedback` lets users submit structured reports when a skill produces wrong output — which skill, which version, what broke. That context flows back to the maintainer, and the fix ships to everyone on the next package update. Every support interaction produces an artifact that prevents the same class of problem for all future users — not just the one who reported it.
 
@@ -129,7 +129,7 @@ The feedback loop runs both directions. `npx @tanstack/intent@latest feedback` l
 | `npx @tanstack/intent@latest meta`                 | List meta-skills for library maintainers            |
 | `npx @tanstack/intent@latest scaffold`             | Print the guided skill generation prompt            |
 | `npx @tanstack/intent@latest validate [dir]`       | Validate SKILL.md files                             |
-| `npx @tanstack/intent@latest setup-github-actions` | Copy CI templates into your repo                    |
+| `npx @tanstack/intent@latest setup`                | Copy CI templates into your repo                    |
 | `npx @tanstack/intent@latest stale [dir] [--json]` | Check skills for version drift                      |
 | `npx @tanstack/intent@latest feedback`             | Submit skill feedback                               |
 

package/dist/artifact-coverage-BAN2W6aH.mjs

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

package/dist/artifact-coverage-wLNVX8yC.mjs

@@ -0,0 +1,128 @@
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { parse } from "yaml";
+
+//#region src/artifact-coverage.ts
+function isRecord(value) {
+	return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function stringValue(value) {
+	return typeof value === "string" && value.trim() ? value : void 0;
+}
+function stringArray(value) {
+	if (!Array.isArray(value)) return [];
+	return value.filter((entry) => typeof entry === "string");
+}
+function detectArtifactKind(fileName) {
+	if (fileName.endsWith("skill_tree.yaml")) return "skill-tree";
+	if (fileName.endsWith("domain_map.yaml")) return "domain-map";
+	return null;
+}
+function readArtifactYaml(artifactPath, warnings) {
+	let parsed;
+	try {
+		parsed = parse(readFileSync(artifactPath, "utf8"));
+	} catch (err) {
+		warnings.push({
+			artifactPath,
+			message: `Invalid YAML: ${err instanceof Error ? err.message : String(err)}`
+		});
+		return null;
+	}
+	if (!isRecord(parsed)) {
+		warnings.push({
+			artifactPath,
+			message: "Artifact YAML must contain an object at the top level"
+		});
+		return null;
+	}
+	return parsed;
+}
+function parseArtifactFile(artifactPath, kind, parsed) {
+	const library = isRecord(parsed.library) ? parsed.library : {};
+	return {
+		path: artifactPath,
+		kind,
+		libraryName: stringValue(library.name),
+		libraryVersion: stringValue(library.version)
+	};
+}
+function parseSkills(artifactPath, kind, parsed) {
+	if (!Array.isArray(parsed.skills)) return [];
+	const skills = [];
+	for (const skill of parsed.skills) {
+		if (!isRecord(skill)) continue;
+		const packagePath = stringValue(skill.package);
+		const packages = stringArray(skill.packages);
+		if (packagePath) packages.push(packagePath);
+		skills.push({
+			artifactPath,
+			artifactKind: kind,
+			name: stringValue(skill.name),
+			slug: stringValue(skill.slug),
+			path: stringValue(skill.path),
+			package: packagePath,
+			packages: [...new Set(packages)].sort((a, b) => a.localeCompare(b)),
+			sources: stringArray(skill.sources),
+			covers: stringArray(skill.covers)
+		});
+	}
+	return skills;
+}
+function parseCoverageIgnores(artifactPath, parsed) {
+	const ignored = (isRecord(parsed.coverage) ? parsed.coverage : null)?.ignored_packages;
+	if (!Array.isArray(ignored)) return [];
+	const ignores = [];
+	for (const entry of ignored) {
+		if (typeof entry === "string") {
+			if (entry.trim()) ignores.push({
+				packageName: entry,
+				artifactPath
+			});
+			continue;
+		}
+		if (!isRecord(entry)) continue;
+		const packageName = stringValue(entry.name);
+		if (!packageName) continue;
+		ignores.push({
+			packageName,
+			reason: stringValue(entry.reason),
+			artifactPath
+		});
+	}
+	return ignores;
+}
+function readIntentArtifacts(root) {
+	const artifactsDir = join(root, "_artifacts");
+	if (!existsSync(artifactsDir)) return null;
+	const warnings = [];
+	const skillTrees = [];
+	const domainMaps = [];
+	const skills = [];
+	const ignoredPackages = [];
+	for (const entry of readdirSync(artifactsDir, { withFileTypes: true })) {
+		if (!entry.isFile()) continue;
+		const kind = detectArtifactKind(entry.name);
+		if (!kind) continue;
+		const artifactPath = join(artifactsDir, entry.name);
+		const parsed = readArtifactYaml(artifactPath, warnings);
+		if (!parsed) continue;
+		const artifactFile = parseArtifactFile(artifactPath, kind, parsed);
+		if (kind === "skill-tree") skillTrees.push(artifactFile);
+		else domainMaps.push(artifactFile);
+		skills.push(...parseSkills(artifactPath, kind, parsed));
+		ignoredPackages.push(...parseCoverageIgnores(artifactPath, parsed));
+	}
+	return {
+		root,
+		artifactsDir,
+		skillTrees: skillTrees.sort((a, b) => a.path.localeCompare(b.path)),
+		domainMaps: domainMaps.sort((a, b) => a.path.localeCompare(b.path)),
+		skills: skills.sort((a, b) => `${a.artifactPath}:${a.slug ?? a.name ?? ""}`.localeCompare(`${b.artifactPath}:${b.slug ?? b.name ?? ""}`)),
+		ignoredPackages: ignoredPackages.sort((a, b) => a.packageName.localeCompare(b.packageName)),
+		warnings
+	};
+}
+
+//#endregion
+export { readIntentArtifacts as t };

package/dist/cli.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import "./utils-COlDcU72.mjs";
-import "./workspace-patterns-U35B5AO-.mjs";
-import { i as parseSkillUse } from "./skill-use-CXOnncWK.mjs";
-import { r as resolveSkillUse } from "./resolver-aFigTqXi.mjs";
-import { t as resolveProjectContext } from "./project-context-CKG-q4rD.mjs";
-import { a as scanIntentsOrFail, c as fail, i as resolveStaleTargets, l as isCliFailure, n as runInstallCommand, o as scanOptionsFromGlobalFlags, r as getMetaDir, s as printWarnings } from "./install-BmVqcbEi.mjs";
+import "./workspace-patterns-BN2A_60g.mjs";
+import { i as parseSkillUse } from "./skill-use-uwGleSOz.mjs";
+import { r as resolveSkillUse } from "./resolver-D2CgIYGg.mjs";
+import { t as resolveProjectContext } from "./project-context-IDLpJU3S.mjs";
+import { a as scanIntentsOrFail, c as fail, i as resolveStaleTargets, l as isCliFailure, n as runInstallCommand, o as scanOptionsFromGlobalFlags, r as getMetaDir, s as printWarnings } from "./install-PUnIfBNC.mjs";
 import { existsSync, readFileSync, readdirSync, realpathSync } from "node:fs";
 import { isAbsolute, join, relative, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -43,7 +43,7 @@ async function runListCommand(options, scanIntentsOrFail$1) {
 		console.log(JSON.stringify(result, null, 2));
 		return;
 	}
-	const { computeSkillNameWidth, printSkillTree, printTable } = await import("./display-DCRCp4-C.mjs");
+	const { computeSkillNameWidth, printSkillTree, printTable } = await import("./display-DvLbcWzq.mjs");
 	const scanCoverage = formatScanCoverage(result);
 	if (result.packages.length === 0) {
 		console.log("No intent-enabled packages found.");
@@ -245,11 +245,13 @@ async function runSetupGithubActionsCommand(root, metaDir) {
 //#endregion
 //#region src/commands/stale.ts
 async function runStaleCommand(targetDir, options, resolveStaleTargets$1) {
-	const { reports } = await resolveStaleTargets$1(targetDir);
+	const { reports, workflowAdvisories = [] } = await resolveStaleTargets$1(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;
@@ -259,8 +261,15 @@ async function runStaleCommand(targetDir, options, resolveStaleTargets$1) {
 		const vLabel = report.skillVersion && report.currentVersion ? ` (${report.skillVersion} → ${report.currentVersion})` : "";
 		console.log(`${report.library}${vLabel}${driftLabel}`);
 		const stale = report.skills.filter((skill) => skill.needsReview);
-		if (stale.length === 0) console.log("  All skills up-to-date");
-		else for (const skill of stale) console.log(`  ⚠ ${skill.name}: ${skill.reasons.join(", ")}`);
+		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();
 	}
 }
@@ -439,6 +448,9 @@ function createCli() {
 	cli.command("edit-package-json", "Update package.json files so skills are published").usage("edit-package-json").action(async () => {
 		await runEditPackageJsonCommand(process.cwd());
 	});
+	cli.command("setup", "Copy Intent CI workflow templates into .github/workflows/").usage("setup").action(async () => {
+		await runSetupGithubActionsCommand(process.cwd(), getMetaDir());
+	});
 	cli.command("setup-github-actions", "Copy Intent CI workflow templates into .github/workflows/").usage("setup-github-actions").action(async () => {
 		await runSetupGithubActionsCommand(process.cwd(), getMetaDir());
 	});

package/dist/{display-DCRCp4-C.mjs → display-DvLbcWzq.mjs}

@@ -1,5 +1,5 @@
 import "./utils-COlDcU72.mjs";
 import "./skill-paths-8k9K9y26.mjs";
-import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-DUgtRJkt.mjs";
+import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-BTZWCjzT.mjs";
 
 export { computeSkillNameWidth, printSkillTree, printTable };

package/dist/index.d.mts

@@ -1,11 +1,29 @@
-import { a as IntentProjectConfig, c as ScanOptions, d as SkillStaleness, f as StalenessReport, i as IntentPackage, l as ScanResult, n as FeedbackPayload, o as MetaFeedbackPayload, p as VersionConflict, r as IntentConfig, s as MetaSkillName, t as AgentName, u as SkillEntry } from "./types-CsySN6Vw.mjs";
-import { i as runEditPackageJson, o as runSetupGithubActions, r as SetupGithubActionsResult, t as EditPackageJsonResult } from "./setup-DDoOLriA.mjs";
+import { _ as StalenessReport, a as IntentArtifactSet, c as IntentConfig, d as MetaFeedbackPayload, f as MetaSkillName, g as SkillStaleness, h as SkillEntry, i as IntentArtifactFile, l as IntentPackage, m as ScanResult, n as FeedbackPayload, o as IntentArtifactSkill, p as ScanOptions, r as IntentArtifactCoverageIgnore, s as IntentArtifactWarning, t as AgentName, u as IntentProjectConfig, v as StalenessSignal, y as VersionConflict } from "./types-_y9b00bI.mjs";
+import { i as runEditPackageJson, o as runSetupGithubActions, r as SetupGithubActionsResult, t as EditPackageJsonResult } from "./setup-D2CGdTsx.mjs";
 
 //#region src/scanner.d.ts
 declare function scanForIntents(root?: string, options?: ScanOptions): ScanResult;
 //#endregion
 //#region src/staleness.d.ts
-declare function checkStaleness(packageDir: string, packageName?: string): Promise<StalenessReport>;
+declare function checkStaleness(packageDir: string, packageName?: string, artifactRoot?: string): Promise<StalenessReport>;
+//#endregion
+//#region src/artifact-coverage.d.ts
+declare function readIntentArtifacts(root: string): IntentArtifactSet | null;
+//#endregion
+//#region src/workflow-review.d.ts
+interface StaleReviewItem {
+  type: string;
+  library: string;
+  subject: string;
+  reasons: Array<string>;
+  artifactPath?: string;
+  packageName?: string;
+  packageRoot?: string;
+  skill?: string;
+}
+declare function collectStaleReviewItems(reports: Array<StalenessReport>): Array<StaleReviewItem>;
+declare function createFailedStaleReviewItem(library: string): StaleReviewItem;
+declare function buildStaleReviewBody(items: Array<StaleReviewItem>): string;
 //#endregion
 //#region src/feedback.d.ts
 declare function containsSecrets(text: string): boolean;
@@ -108,4 +126,4 @@ declare class ResolveSkillUseError extends Error {
 declare function isResolveSkillUseError(error: unknown): error is ResolveSkillUseError;
 declare function resolveSkillUse(use: string, scanResult: ScanResult): ResolveSkillResult;
 //#endregion
-export { type AgentName, type EditPackageJsonResult, type FeedbackPayload, type IntentConfig, type IntentPackage, type IntentProjectConfig, type MetaFeedbackPayload, type MetaSkillName, type ResolveSkillResult, ResolveSkillUseError, type ResolveSkillUseErrorCode, type ScanOptions, type ScanResult, type SetupGithubActionsResult, type SkillEntry, type SkillStaleness, type SkillUse, SkillUseParseError, type SkillUseParseErrorCode, type StalenessReport, checkStaleness, containsSecrets, findSkillFiles, formatSkillUse, getDeps, hasGhCli, isResolveSkillUseError, isSkillUseParseError, metaToMarkdown, parseFrontmatter, parseSkillUse, resolveDepDir, resolveFrequency, resolveSkillUse, runEditPackageJson, runSetupGithubActions, scanForIntents, submitFeedback, submitMetaFeedback, toMarkdown, validateMetaPayload, validatePayload };
+export { type AgentName, type EditPackageJsonResult, type FeedbackPayload, type IntentArtifactCoverageIgnore, type IntentArtifactFile, type IntentArtifactSet, type IntentArtifactSkill, type IntentArtifactWarning, type IntentConfig, type IntentPackage, type IntentProjectConfig, type MetaFeedbackPayload, type MetaSkillName, type ResolveSkillResult, ResolveSkillUseError, type ResolveSkillUseErrorCode, type ScanOptions, type ScanResult, type SetupGithubActionsResult, type SkillEntry, type SkillStaleness, type SkillUse, SkillUseParseError, type SkillUseParseErrorCode, type StaleReviewItem, type StalenessReport, type StalenessSignal, buildStaleReviewBody, checkStaleness, collectStaleReviewItems, containsSecrets, createFailedStaleReviewItem, findSkillFiles, formatSkillUse, getDeps, hasGhCli, isResolveSkillUseError, isSkillUseParseError, metaToMarkdown, parseFrontmatter, parseSkillUse, readIntentArtifacts, resolveDepDir, resolveFrequency, resolveSkillUse, runEditPackageJson, runSetupGithubActions, scanForIntents, submitFeedback, submitMetaFeedback, toMarkdown, validateMetaPayload, validatePayload };

package/dist/index.mjs

@@ -1,16 +1,133 @@
 import { a as parseFrontmatter, n as findSkillFiles, o as resolveDepDir, r as getDeps } from "./utils-COlDcU72.mjs";
 import "./skill-paths-8k9K9y26.mjs";
-import { t as scanForIntents } from "./scanner-DKL8v8is.mjs";
-import "./workspace-patterns-U35B5AO-.mjs";
-import { t as checkStaleness } from "./staleness-DorwfGrf.mjs";
-import { i as parseSkillUse, n as formatSkillUse, r as isSkillUseParseError, t as SkillUseParseError } from "./skill-use-CXOnncWK.mjs";
-import { n as isResolveSkillUseError, r as resolveSkillUse, t as ResolveSkillUseError } from "./resolver-aFigTqXi.mjs";
-import "./project-context-CKG-q4rD.mjs";
-import { r as runSetupGithubActions, t as runEditPackageJson } from "./setup-JJvjiGkM.mjs";
+import { t as scanForIntents } from "./scanner-CW59cxE_.mjs";
+import "./workspace-patterns-BN2A_60g.mjs";
+import { t as readIntentArtifacts } from "./artifact-coverage-wLNVX8yC.mjs";
+import { n as checkStaleness } from "./staleness-PdgakrCQ.mjs";
+import { i as parseSkillUse, n as formatSkillUse, r as isSkillUseParseError, t as SkillUseParseError } from "./skill-use-uwGleSOz.mjs";
+import { n as isResolveSkillUseError, r as resolveSkillUse, t as ResolveSkillUseError } from "./resolver-D2CgIYGg.mjs";
+import "./project-context-IDLpJU3S.mjs";
+import { r as runSetupGithubActions, t as runEditPackageJson } from "./setup-DfLsziXU.mjs";
 import { readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { execFileSync, execSync } from "node:child_process";
 
+//#region src/workflow-review.ts
+function collectStaleReviewItems(reports) {
+	const items = [];
+	for (const report of reports) {
+		for (const skill of report.skills ?? []) {
+			if (!skill?.needsReview) continue;
+			items.push({
+				type: "stale-skill",
+				library: report.library,
+				subject: skill.name,
+				reasons: skill.reasons ?? []
+			});
+		}
+		for (const signal of report.signals ?? []) {
+			if (signal?.needsReview === false) continue;
+			items.push({
+				type: signal?.type ?? "review-signal",
+				library: signal?.library ?? report.library,
+				subject: signal?.packageName ?? signal?.packageRoot ?? signal?.skill ?? signal?.artifactPath ?? signal?.subject ?? report.library,
+				reasons: signal?.reasons ?? [],
+				artifactPath: signal?.artifactPath,
+				packageName: signal?.packageName,
+				packageRoot: signal?.packageRoot,
+				skill: signal?.skill
+			});
+		}
+	}
+	return items;
+}
+function createFailedStaleReviewItem(library) {
+	return {
+		type: "stale-check-failed",
+		library,
+		subject: "intent stale --json",
+		reasons: ["The stale check command failed. Review the workflow logs before updating skills."]
+	};
+}
+function buildStaleReviewBody(items) {
+	const grouped = /* @__PURE__ */ new Map();
+	for (const item of items) grouped.set(item.type, (grouped.get(item.type) ?? 0) + 1);
+	const signalRows = [...grouped.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([type, count]) => `| \`${type}\` | ${count} |`);
+	const itemRows = items.map((item) => {
+		const subject = item.subject ? `\`${item.subject}\`` : "-";
+		const reasons = item.reasons?.length ? item.reasons.join("; ") : "-";
+		return `| \`${item.type}\` | ${subject} | \`${item.library}\` | ${reasons} |`;
+	});
+	const prompt = [
+		"You are helping maintain Intent skills for this repository.",
+		"",
+		"Goal:",
+		"Resolve the Intent skill review signals below while preserving the existing scope, taxonomy, and maintainer-reviewed artifacts.",
+		"",
+		"Review signals:",
+		JSON.stringify(items, null, 2),
+		"",
+		"Required workflow:",
+		"1. Read the existing `_artifacts/*domain_map.yaml`, `_artifacts/*skill_tree.yaml`, and generated `skills/**/SKILL.md` files.",
+		"2. Read each flagged package package.json, public exports, README/docs if present, and source entry points.",
+		"3. Compare flagged packages against the existing domains, skills, tasks, packages, covers, sources, tensions, and cross-references in the artifacts.",
+		"4. For each signal, decide whether it means existing skill coverage, a missing generated skill, a new skill candidate, out-of-scope coverage, or deferred work.",
+		"",
+		"Maintainer questions:",
+		"Before editing skills or artifacts, ask the maintainer:",
+		"1. For each flagged package, is this package user-facing enough to need agent guidance?",
+		"2. If yes, should it extend an existing skill or become a new skill?",
+		"3. If it extends an existing skill, which current skill should own it?",
+		"4. If it is out of scope, what short reason should be recorded in artifact coverage ignores?",
+		"5. Are any of these packages experimental or unstable enough to exclude for now?",
+		"",
+		"Decision rules:",
+		"- Do not auto-generate skills.",
+		"- Do not create broad new skill areas without maintainer confirmation.",
+		"- Prefer adding package coverage to an existing skill when the package is an implementation variant of an existing domain.",
+		"- Create a new skill only when the package introduces a distinct developer task or failure mode.",
+		"- Preserve current naming, path, and package layout conventions.",
+		"- Keep generated skills under the package-local `skills/` directory.",
+		"- Keep repo-root `_artifacts` as the reviewed plan.",
+		"",
+		"If maintainer confirms updates:",
+		"1. Update the relevant `_artifacts/*domain_map.yaml` or `_artifacts/*skill_tree.yaml`.",
+		"2. Update or create `SKILL.md` files only for confirmed coverage changes.",
+		"3. Keep `sources` aligned between artifact skill entries and SKILL frontmatter.",
+		"4. Bump `library_version` only for skills whose covered source package version changed.",
+		"5. Run `npx @tanstack/intent@latest validate` on touched skill directories.",
+		"6. Summarize every package as one of: existing-skill coverage, new skill, ignored, or deferred."
+	].join("\n");
+	return [
+		"## Intent Skill Review Needed",
+		"",
+		"Intent found skills, artifact coverage, or workspace package coverage that need maintainer review.",
+		"",
+		"### Summary",
+		"",
+		"| Signal | Count |",
+		"| --- | ---: |",
+		...signalRows,
+		"",
+		"### Review Items",
+		"",
+		"| Signal | Subject | Library | Reason |",
+		"| --- | --- | --- | --- |",
+		...itemRows,
+		"",
+		"### Agent Prompt",
+		"",
+		"Paste this into your coding agent:",
+		"",
+		"```text",
+		prompt,
+		"```",
+		"",
+		"This PR is a review reminder only. It does not update skills automatically."
+	].join("\n");
+}
+
+//#endregion
 //#region src/feedback.ts
 const META_FEEDBACK_REPO = "TanStack/intent";
 const SECRET_PATTERNS = [
@@ -274,4 +391,4 @@ function submitMetaFeedback(payload, opts) {
 }
 
 //#endregion
-export { ResolveSkillUseError, SkillUseParseError, checkStaleness, containsSecrets, findSkillFiles, formatSkillUse, getDeps, hasGhCli, isResolveSkillUseError, isSkillUseParseError, metaToMarkdown, parseFrontmatter, parseSkillUse, resolveDepDir, resolveFrequency, resolveSkillUse, runEditPackageJson, runSetupGithubActions, scanForIntents, submitFeedback, submitMetaFeedback, toMarkdown, validateMetaPayload, validatePayload };
+export { ResolveSkillUseError, SkillUseParseError, buildStaleReviewBody, checkStaleness, collectStaleReviewItems, containsSecrets, createFailedStaleReviewItem, findSkillFiles, formatSkillUse, getDeps, hasGhCli, isResolveSkillUseError, isSkillUseParseError, metaToMarkdown, parseFrontmatter, parseSkillUse, readIntentArtifacts, resolveDepDir, resolveFrequency, resolveSkillUse, runEditPackageJson, runSetupGithubActions, scanForIntents, submitFeedback, submitMetaFeedback, toMarkdown, validateMetaPayload, validatePayload };

package/dist/{install-BmVqcbEi.mjs → install-PUnIfBNC.mjs}

@@ -1,5 +1,5 @@
-import { i as parseSkillUse, n as formatSkillUse } from "./skill-use-CXOnncWK.mjs";
-import { t as resolveProjectContext } from "./project-context-CKG-q4rD.mjs";
+import { i as parseSkillUse, n as formatSkillUse } from "./skill-use-uwGleSOz.mjs";
+import { t as resolveProjectContext } from "./project-context-IDLpJU3S.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join, relative, resolve } from "node:path";
 import { parse } from "yaml";
@@ -28,11 +28,25 @@ function printWarnings(warnings) {
 
 //#endregion
 //#region src/cli-support.ts
+const INTENT_CHECK_SKILLS_WORKFLOW_VERSION = 2;
 function getMetaDir() {
 	return join(dirname(fileURLToPath(import.meta.url)), "..", "meta");
 }
+function getCheckSkillsWorkflowAdvisories(root) {
+	const workflowPath = join(root, ".github", "workflows", "check-skills.yml");
+	if (!existsSync(workflowPath)) return [];
+	let content;
+	try {
+		content = readFileSync(workflowPath, "utf8");
+	} catch {
+		return [];
+	}
+	const versionMatch = content.match(/intent-workflow-version:\s*(\d+)/);
+	if ((versionMatch ? Number(versionMatch[1]) : 0) >= INTENT_CHECK_SKILLS_WORKFLOW_VERSION) return [];
+	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-CRZITpcY.mjs");
+	const { scanForIntents } = await import("./scanner-DlkcbVye.mjs");
 	try {
 		return scanForIntents(void 0, options);
 	} catch (err) {
@@ -45,31 +59,53 @@ function scanOptionsFromGlobalFlags(options) {
 	if (options.global) return { scope: "local-and-global" };
 	return { scope: "local" };
 }
-function readPackageName(root) {
-	try {
-		const pkgJson = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
-		return typeof pkgJson.name === "string" ? pkgJson.name : relative(process.cwd(), root) || "unknown";
-	} catch {
-		return relative(process.cwd(), root) || "unknown";
-	}
-}
 async function resolveStaleTargets(targetDir) {
 	const resolvedRoot = targetDir ? resolve(process.cwd(), targetDir) : process.cwd();
 	const context = resolveProjectContext({
 		cwd: process.cwd(),
 		targetPath: targetDir
 	});
-	const { checkStaleness } = await import("./staleness-NF-lxfXf.mjs");
-	if (context.packageRoot && (context.targetSkillsDir !== null || resolvedRoot !== context.workspaceRoot)) return { reports: [await checkStaleness(context.packageRoot, readPackageName(context.packageRoot))] };
-	if (existsSync(join(resolvedRoot, "skills"))) return { reports: [await checkStaleness(resolvedRoot, readPackageName(resolvedRoot))] };
-	const { findPackagesWithSkills, findWorkspaceRoot } = await import("./workspace-patterns-DbnA0peB.mjs");
+	const workflowAdvisories = getCheckSkillsWorkflowAdvisories(context.workspaceRoot ?? context.packageRoot ?? resolvedRoot);
+	const { buildWorkspaceCoverageSignals, checkStaleness, readPackageName } = await import("./staleness-DpbmYod4.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 { findPackagesWithSkills, findWorkspacePackages, findWorkspaceRoot } = await import("./workspace-patterns-x-dLZxx4.mjs");
 	const workspaceRoot = findWorkspaceRoot(resolvedRoot);
 	if (workspaceRoot) {
-		const packageDirs = findPackagesWithSkills(workspaceRoot);
-		if (packageDirs.length > 0) return { reports: await Promise.all(packageDirs.map((packageDir) => checkStaleness(packageDir, readPackageName(packageDir)))) };
+		const packageDirsWithSkills = findPackagesWithSkills(workspaceRoot);
+		const allPackageDirs = findWorkspacePackages(workspaceRoot);
+		const reports = await Promise.all(packageDirsWithSkills.map((packageDir) => checkStaleness(packageDir, readPackageName(packageDir), workspaceRoot)));
+		const { readIntentArtifacts } = await import("./artifact-coverage-BAN2W6aH.mjs");
+		const coverageSignals = buildWorkspaceCoverageSignals({
+			artifactRoot: workspaceRoot,
+			artifacts: existsSync(join(workspaceRoot, "_artifacts")) ? readIntentArtifacts(workspaceRoot) : null,
+			packageDirs: allPackageDirs
+		});
+		if (coverageSignals.length > 0) reports.push({
+			library: relative(process.cwd(), workspaceRoot) || "workspace",
+			currentVersion: null,
+			skillVersion: null,
+			versionDrift: null,
+			skills: [],
+			signals: coverageSignals
+		});
+		if (reports.length > 0) return {
+			reports,
+			workflowAdvisories
+		};
 	}
+	if (existsSync(join(resolvedRoot, "skills"))) return {
+		reports: [await checkStaleness(resolvedRoot, readPackageName(resolvedRoot))],
+		workflowAdvisories
+	};
 	const staleResult = await scanIntentsOrFail();
-	return { reports: await Promise.all(staleResult.packages.map((pkg) => checkStaleness(pkg.packageRoot, pkg.name))) };
+	return {
+		reports: await Promise.all(staleResult.packages.map((pkg) => checkStaleness(pkg.packageRoot, pkg.name))),
+		workflowAdvisories
+	};
 }
 
 //#endregion

package/dist/intent-library.mjs

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import "./utils-COlDcU72.mjs";
 import "./skill-paths-8k9K9y26.mjs";
-import "./workspace-patterns-U35B5AO-.mjs";
-import "./project-context-CKG-q4rD.mjs";
-import { t as INSTALL_PROMPT } from "./install-BmVqcbEi.mjs";
-import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-DUgtRJkt.mjs";
-import { t as scanLibrary } from "./library-scanner-DFFreLjW.mjs";
+import "./workspace-patterns-BN2A_60g.mjs";
+import "./project-context-IDLpJU3S.mjs";
+import { t as INSTALL_PROMPT } from "./install-PUnIfBNC.mjs";
+import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-BTZWCjzT.mjs";
+import { t as scanLibrary } from "./library-scanner-Cl-XPEMf.mjs";
 
 //#region src/intent-library.ts
 function cmdList() {

package/dist/library-scanner.d.mts

@@ -1,4 +1,4 @@
-import { u as SkillEntry } from "./types-CsySN6Vw.mjs";
+import { h as SkillEntry } from "./types-_y9b00bI.mjs";
 
 //#region src/library-scanner.d.ts
 interface LibraryPackage {

package/dist/library-scanner.mjs

@@ -1,5 +1,5 @@
 import "./utils-COlDcU72.mjs";
 import "./skill-paths-8k9K9y26.mjs";
-import { t as scanLibrary } from "./library-scanner-DFFreLjW.mjs";
+import { t as scanLibrary } from "./library-scanner-Cl-XPEMf.mjs";
 
 export { scanLibrary };

package/dist/{project-context-CKG-q4rD.mjs → project-context-IDLpJU3S.mjs}

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

package/dist/{resolver-aFigTqXi.mjs → resolver-D2CgIYGg.mjs}

@@ -1,4 +1,4 @@
-import { i as parseSkillUse } from "./skill-use-CXOnncWK.mjs";
+import { i as parseSkillUse } from "./skill-use-uwGleSOz.mjs";
 
 //#region src/resolver.ts
 var ResolveSkillUseError = class extends Error {

package/dist/{scanner-DKL8v8is.mjs → scanner-CW59cxE_.mjs}

@@ -1,6 +1,6 @@
 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 { i as resolveWorkspacePackages, n as findWorkspaceRoot, r as readWorkspacePatterns } from "./workspace-patterns-U35B5AO-.mjs";
+import { a as resolveWorkspacePackages, i as readWorkspacePatterns, r as findWorkspaceRoot } from "./workspace-patterns-BN2A_60g.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join, relative, sep } from "node:path";
 

package/dist/scanner-DlkcbVye.mjs

@@ -0,0 +1,6 @@
+import "./utils-COlDcU72.mjs";
+import "./skill-paths-8k9K9y26.mjs";
+import { t as scanForIntents } from "./scanner-CW59cxE_.mjs";
+import "./workspace-patterns-BN2A_60g.mjs";
+
+export { scanForIntents };

package/dist/{setup-JJvjiGkM.mjs → setup-DfLsziXU.mjs}

@@ -1,5 +1,5 @@
-import { n as findWorkspaceRoot, r as readWorkspacePatterns, t as findPackagesWithSkills } from "./workspace-patterns-U35B5AO-.mjs";
-import { t as resolveProjectContext } from "./project-context-CKG-q4rD.mjs";
+import { i as readWorkspacePatterns, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-BN2A_60g.mjs";
+import { t as resolveProjectContext } from "./project-context-IDLpJU3S.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-DDoOLriA.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-D2CGdTsx.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 { i as resolveWorkspacePackages, n as findWorkspaceRoot, r as readWorkspacePatterns, t as findPackagesWithSkills } from "./workspace-patterns-U35B5AO-.mjs";
-import "./project-context-CKG-q4rD.mjs";
-import { n as runEditPackageJsonAll, r as runSetupGithubActions, t as runEditPackageJson } from "./setup-JJvjiGkM.mjs";
+import { a as resolveWorkspacePackages, i as readWorkspacePatterns, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-BN2A_60g.mjs";
+import "./project-context-IDLpJU3S.mjs";
+import { n as runEditPackageJsonAll, r as runSetupGithubActions, t as runEditPackageJson } from "./setup-DfLsziXU.mjs";
 
 export { findPackagesWithSkills, findWorkspaceRoot, readWorkspacePatterns, resolveWorkspacePackages, runEditPackageJson, runEditPackageJsonAll, runSetupGithubActions };