@tanstack/intent 0.0.13 → 0.0.19

package/dist/cli.mjs

@@ -1,39 +1,88 @@
 #!/usr/bin/env node
-import { n as parseFrontmatter, t as findSkillFiles } from "./utils-DH3jY3CI.mjs";
-import { t as scanForIntents } from "./scanner-dIYdkHQ1.mjs";
-import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-D_XzuGnu.mjs";
+import { t as INSTALL_PROMPT } from "./install-prompt-C0M-U3WZ.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { dirname, join, relative, sep } from "node:path";
-import { parse } from "yaml";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 //#region src/cli.ts
 function getMetaDir() {
 	return join(dirname(fileURLToPath(import.meta.url)), "..", "meta");
 }
-async function cmdList(args) {
-	const jsonOutput = args.includes("--json");
-	let result;
+function fail(message, exitCode = 1) {
+	throw {
+		message,
+		exitCode
+	};
+}
+function isCliFailure(value) {
+	return !!value && typeof value === "object" && "message" in value && typeof value.message === "string" && "exitCode" in value && typeof value.exitCode === "number";
+}
+async function scanIntentsOrFail() {
+	const { scanForIntents } = await import("./scanner-B1UvuEBQ.mjs");
 	try {
-		result = await scanForIntents();
+		return await scanForIntents();
 	} catch (err) {
-		console.error(err.message);
-		process.exit(1);
+		fail(err.message);
+	}
+}
+function printWarnings(warnings) {
+	if (warnings.length === 0) return;
+	console.log("Warnings:");
+	for (const warning of warnings) console.log(`  ⚠ ${warning}`);
+}
+function formatScanCoverage(result) {
+	const coverage = [];
+	if (result.nodeModules.local.scanned) coverage.push("project node_modules");
+	if (result.nodeModules.global.scanned) coverage.push("global node_modules");
+	return coverage.join(", ");
+}
+function printVersionConflicts(result) {
+	if (result.conflicts.length === 0) return;
+	console.log("\nVersion conflicts:\n");
+	for (const conflict of result.conflicts) {
+		console.log(`  ${conflict.packageName} -> using ${conflict.chosen.version}`);
+		console.log(`    chosen: ${conflict.chosen.packageRoot}`);
+		for (const variant of conflict.variants) {
+			if (variant.packageRoot === conflict.chosen.packageRoot) continue;
+			console.log(`    also found: ${variant.version} at ${variant.packageRoot}`);
+		}
+		console.log();
+	}
+}
+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");
+}
+async function cmdList(args) {
+	const { computeSkillNameWidth, printSkillTree, printTable } = await import("./display-CuCDLPP_.mjs");
+	const jsonOutput = args.includes("--json");
+	const result = await scanIntentsOrFail();
 	if (jsonOutput) {
 		console.log(JSON.stringify(result, null, 2));
 		return;
 	}
+	const scanCoverage = formatScanCoverage(result);
 	if (result.packages.length === 0) {
 		console.log("No intent-enabled packages found.");
+		if (scanCoverage) console.log(`Scanned: ${scanCoverage}`);
 		if (result.warnings.length > 0) {
-			console.log(`\nWarnings:`);
-			for (const w of result.warnings) console.log(`  ⚠ ${w}`);
+			console.log();
+			printWarnings(result.warnings);
 		}
 		return;
 	}
 	const totalSkills = result.packages.reduce((sum, p) => sum + p.skills.length, 0);
 	console.log(`\n${result.packages.length} intent-enabled packages, ${totalSkills} skills (${result.packageManager})\n`);
+	if (scanCoverage) console.log(`Scanned: ${scanCoverage}${result.nodeModules.global.scanned ? " (local packages take precedence)" : ""}\n`);
 	printTable([
 		"PACKAGE",
 		"VERSION",
@@ -45,6 +94,7 @@ async function cmdList(args) {
 		String(pkg.skills.length),
 		pkg.intent.requires?.join(", ") || "–"
 	]));
+	printVersionConflicts(result);
 	const nameWidth = computeSkillNameWidth(result.packages.map((p) => p.skills));
 	const showTypes = result.packages.some((p) => p.skills.some((s) => s.type));
 	console.log(`\nSkills:\n`);
@@ -60,35 +110,21 @@ async function cmdList(args) {
 	console.log(`  Submit feedback on skill usage to help maintainers improve the skills.`);
 	console.log(`  Load: node_modules/@tanstack/intent/meta/feedback-collection/SKILL.md`);
 	console.log();
-	if (result.warnings.length > 0) {
-		console.log(`Warnings:`);
-		for (const w of result.warnings) console.log(`  ⚠ ${w}`);
-	}
+	printWarnings(result.warnings);
 }
-function cmdMeta(args) {
+async function cmdMeta(args) {
+	const { parseFrontmatter } = await import("./utils-XSyO19J6.mjs");
 	const metaDir = getMetaDir();
-	if (!existsSync(metaDir)) {
-		console.error("Meta-skills directory not found.");
-		process.exit(1);
-	}
+	if (!existsSync(metaDir)) fail("Meta-skills directory not found.");
 	if (args.length > 0) {
 		const name = args[0];
-		if (name.includes("..") || name.includes("/") || name.includes("\\")) {
-			console.error(`Invalid meta-skill name: "${name}"`);
-			process.exit(1);
-		}
+		if (name.includes("..") || name.includes("/") || name.includes("\\")) fail(`Invalid meta-skill name: "${name}"`);
 		const skillFile = join(metaDir, name, "SKILL.md");
-		if (!existsSync(skillFile)) {
-			console.error(`Meta-skill "${name}" not found.`);
-			console.error(`Run \`npx @tanstack/intent meta\` to list available meta-skills.`);
-			process.exit(1);
-		}
+		if (!existsSync(skillFile)) fail(`Meta-skill "${name}" not found. Run \`intent meta\` to list available meta-skills.`);
 		try {
 			console.log(readFileSync(skillFile, "utf8"));
 		} catch (err) {
-			const msg = err instanceof Error ? err.message : String(err);
-			console.error(`Failed to read meta-skill "${name}": ${msg}`);
-			process.exit(1);
+			fail(`Failed to read meta-skill "${name}": ${err instanceof Error ? err.message : String(err)}`);
 		}
 		return;
 	}
@@ -131,19 +167,45 @@ function collectPackagingWarnings(root) {
 	}
 	return warnings;
 }
-function cmdValidate(args) {
+function resolvePackageRoot(startDir) {
+	let dir = startDir;
+	while (true) {
+		if (existsSync(join(dir, "package.json"))) return dir;
+		const next = dirname(dir);
+		if (next === dir) return startDir;
+		dir = next;
+	}
+}
+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 ? join(process.cwd(), targetDir) : process.cwd();
+	const { checkStaleness } = await import("./staleness-CWWuoPop.mjs");
+	if (existsSync(join(resolvedRoot, "skills"))) return { reports: [await checkStaleness(resolvedRoot, readPackageName(resolvedRoot))] };
+	const { findPackagesWithSkills, findWorkspaceRoot } = await import("./setup.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 staleResult = await scanIntentsOrFail();
+	return { reports: await Promise.all(staleResult.packages.map((pkg) => checkStaleness(pkg.packageRoot, pkg.name))) };
+}
+async function cmdValidate(args) {
+	const [{ parse: parseYaml }, { findSkillFiles }] = await Promise.all([import("yaml"), import("./utils-XSyO19J6.mjs")]);
 	const targetDir = args[0] ?? "skills";
 	const skillsDir = join(process.cwd(), targetDir);
-	if (!existsSync(skillsDir)) {
-		console.error(`Skills directory not found: ${skillsDir}`);
-		process.exit(1);
-	}
+	const packageRoot = resolvePackageRoot(skillsDir);
+	if (!existsSync(skillsDir)) fail(`Skills directory not found: ${skillsDir}`);
 	const errors = [];
 	const skillFiles = findSkillFiles(skillsDir);
-	if (skillFiles.length === 0) {
-		console.error("No SKILL.md files found");
-		process.exit(1);
-	}
+	if (skillFiles.length === 0) fail("No SKILL.md files found");
 	for (const filePath of skillFiles) {
 		const rel = relative(process.cwd(), filePath);
 		const content = readFileSync(filePath, "utf8");
@@ -164,7 +226,7 @@ function cmdValidate(args) {
 		}
 		let fm;
 		try {
-			fm = parse(match[1]);
+			fm = parseYaml(match[1]);
 		} catch {
 			errors.push({
 				file: rel,
@@ -224,7 +286,7 @@ function cmdValidate(args) {
 			continue;
 		}
 		if (fileName.endsWith(".yaml")) try {
-			parse(content);
+			parseYaml(content);
 		} catch {
 			errors.push({
 				file: relative(process.cwd(), artifactPath),
@@ -232,20 +294,11 @@ function cmdValidate(args) {
 			});
 		}
 	}
-	const warnings = collectPackagingWarnings(process.cwd());
-	const printWarnings = (log) => {
-		if (warnings.length === 0) return;
-		log(`\n⚠ Packaging warnings:`);
-		for (const w of warnings) log(`  ${w}`);
-	};
-	if (errors.length > 0) {
-		console.error(`\n❌ Validation failed with ${errors.length} error(s):\n`);
-		for (const { file, message } of errors) console.error(`  ${file}: ${message}`);
-		printWarnings(console.error);
-		process.exit(1);
-	}
+	const warnings = collectPackagingWarnings(packageRoot);
+	if (errors.length > 0) fail(buildValidationFailure(errors, warnings));
 	console.log(`✅ Validated ${skillFiles.length} skill files — all passed`);
-	printWarnings(console.log);
+	if (warnings.length > 0) console.log();
+	printWarnings(warnings);
 }
 function cmdScaffold() {
 	const metaDir = getMetaDir();
@@ -306,13 +359,13 @@ This produces: individual SKILL.md files.
 
 ## After all skills are generated
 
-1. Run \`npx @tanstack/intent validate\` in each package directory
+1. Run \`intent validate\` in each package directory
 2. Commit skills/ and artifacts
 3. For each publishable package, run: \`npx @tanstack/intent add-library-bin\`
 4. For each publishable package, run: \`npx @tanstack/intent edit-package-json\`
 5. Ensure each package has \`@tanstack/intent\` as a devDependency
 6. Create a \`skill:<skill-name>\` label on the GitHub repo for each skill (use \`gh label create\`)
-7. Add a README note: "If you use an AI agent, run \`npx @tanstack/intent install\`"
+7. Add a README note: "If you use an AI agent, run \`npx @tanstack/intent@latest install\`"
 `;
 	console.log(prompt);
 }
@@ -327,122 +380,148 @@ Usage:
   intent add-library-bin         Generate bin/intent.{js,mjs} bridge file
   intent edit-package-json       Wire package.json (files, bin) for skill publishing
   intent setup-github-actions    Copy CI workflow templates to .github/workflows/
-  intent stale                   Check skills for staleness`;
-const command = process.argv[2];
-const commandArgs = process.argv.slice(3);
-switch (command) {
-	case "list":
-		await cmdList(commandArgs);
-		break;
-	case "meta":
-		cmdMeta(commandArgs);
-		break;
-	case "validate":
-		cmdValidate(commandArgs);
-		break;
-	case "install":
-		console.log(`You are an AI assistant helping a developer set up skill-to-task mappings for their project.
-
-Follow these steps in order:
-
-1. CHECK FOR EXISTING MAPPINGS
-   Search the project's agent config files (CLAUDE.md, AGENTS.md, .cursorrules,
-   .github/copilot-instructions.md) for a block delimited by:
-     <!-- intent-skills:start -->
-     <!-- intent-skills:end -->
-   - If found: show the user the current mappings and ask "What would you like to update?"
-     Then skip to step 4 with their requested changes.
-   - If not found: continue to step 2.
-
-2. DISCOVER AVAILABLE SKILLS
-   Run: intent list
-   This outputs each skill's name, description, and full path — grouped by package.
-
-3. SCAN THE REPOSITORY
-   Build a picture of the project's structure and patterns:
-   - Read package.json for library dependencies
-   - Survey the directory layout (src/, app/, routes/, components/, api/, etc.)
-   - Note recurring patterns (routing, data fetching, auth, UI components, etc.)
-
-   Based on this, propose 3–5 skill-to-task mappings. For each one explain:
-   - The task or code area (in plain language the user would recognise)
-   - Which skill applies and why
-
-   Then ask: "What other tasks do you commonly use AI coding agents for?
-   I'll create mappings for those too."
-
-4. WRITE THE MAPPINGS BLOCK
-   Once you have the full set of mappings, write or update the agent config file
-   (prefer CLAUDE.md; create it if none exists) with this exact block:
-
-<!-- intent-skills:start -->
-# Skill mappings — when working in these areas, load the linked skill file into context.
-skills:
-  - task: "describe the task or code area here"
-    load: "node_modules/package-name/skills/skill-name/SKILL.md"
-<!-- intent-skills:end -->
-
-   Rules:
-   - Use the user's own words for task descriptions
-   - Include the exact path from \`intent list\` output so agents can load it directly
-   - Keep entries concise — this block is read on every agent task
-   - Preserve all content outside the block tags unchanged`);
-		break;
-	case "scaffold":
-		cmdScaffold();
-		break;
-	case "stale": {
-		const { checkStaleness } = await import("./staleness-B5gUj7FR.mjs");
-		const { scanForIntents: scanStale } = await import("./scanner-DQeiZRzp.mjs");
-		let staleResult;
-		try {
-			staleResult = await scanStale();
-		} catch (err) {
-			console.error(err.message);
-			process.exit(1);
+  intent stale [dir] [--json]    Check skills for staleness`;
+const HELP_BY_COMMAND = {
+	list: `${USAGE}
+
+Examples:
+  intent list
+  intent list --json`,
+	meta: `intent meta [name]
+
+List shipped meta-skills, or print a single meta-skill by name.
+
+Examples:
+  intent meta
+  intent meta domain-discovery`,
+	validate: `intent validate [dir]
+
+Validate SKILL.md files in the target directory.
+
+Examples:
+  intent validate
+  intent validate packages/query/skills`,
+	install: `intent install
+
+Print the install prompt used to set up skill-to-task mappings.`,
+	scaffold: `intent scaffold
+
+Print the guided maintainer prompt for generating skills.`,
+	stale: `intent stale [dir] [--json]
+
+Check installed skills for version and source drift.
+
+Examples:
+  intent stale
+  intent stale packages/query
+  intent stale --json`,
+	"add-library-bin": `intent add-library-bin
+
+Generate bin/intent.{js,mjs} bridge files for publishable packages.`,
+	"edit-package-json": `intent edit-package-json
+
+Update package.json files so skills and shims are published.`,
+	"setup-github-actions": `intent setup-github-actions
+
+Copy Intent CI workflow templates into .github/workflows/.`
+};
+function isHelpFlag(arg) {
+	return arg === "-h" || arg === "--help";
+}
+function printHelp(command) {
+	if (!command) {
+		console.log(`${USAGE}
+
+Run \`intent help <command>\` for details on a specific command.`);
+		return;
+	}
+	console.log(HELP_BY_COMMAND[command] ?? USAGE);
+}
+async function main(argv = process.argv.slice(2)) {
+	const command = argv[0];
+	const commandArgs = argv.slice(1);
+	try {
+		if (!command || isHelpFlag(command)) {
+			printHelp();
+			return 0;
 		}
-		if (staleResult.packages.length === 0) {
-			console.log("No intent-enabled packages found.");
-			break;
+		if (command === "help") {
+			printHelp(commandArgs[0]);
+			return 0;
 		}
-		const jsonStale = commandArgs.includes("--json");
-		const reports = await Promise.all(staleResult.packages.map((pkg) => {
-			return checkStaleness(join(process.cwd(), "node_modules", pkg.name), pkg.name);
-		}));
-		if (jsonStale) {
-			console.log(JSON.stringify(reports, null, 2));
-			break;
+		if (isHelpFlag(commandArgs[0])) {
+			printHelp(command);
+			return 0;
 		}
-		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((s) => s.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(", ")}`);
-			console.log();
+		switch (command) {
+			case "list":
+				await cmdList(commandArgs);
+				return 0;
+			case "meta":
+				await cmdMeta(commandArgs);
+				return 0;
+			case "validate":
+				await cmdValidate(commandArgs);
+				return 0;
+			case "install":
+				console.log(INSTALL_PROMPT);
+				return 0;
+			case "scaffold":
+				cmdScaffold();
+				return 0;
+			case "stale": {
+				const jsonStale = commandArgs.includes("--json");
+				const { reports } = await resolveStaleTargets(commandArgs.find((arg) => !arg.startsWith("-")));
+				if (reports.length === 0) {
+					console.log("No intent-enabled packages found.");
+					return 0;
+				}
+				if (jsonStale) {
+					console.log(JSON.stringify(reports, null, 2));
+					return 0;
+				}
+				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((s) => s.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(", ")}`);
+					console.log();
+				}
+				return 0;
+			}
+			case "add-library-bin": {
+				const { runAddLibraryBinAll } = await import("./setup.mjs");
+				runAddLibraryBinAll(process.cwd());
+				return 0;
+			}
+			case "edit-package-json": {
+				const { runEditPackageJsonAll } = await import("./setup.mjs");
+				runEditPackageJsonAll(process.cwd());
+				return 0;
+			}
+			case "setup-github-actions": {
+				const { runSetupGithubActions } = await import("./setup.mjs");
+				runSetupGithubActions(process.cwd(), getMetaDir());
+				return 0;
+			}
+			default:
+				printHelp();
+				return command ? 1 : 0;
 		}
-		break;
-	}
-	case "add-library-bin": {
-		const { runAddLibraryBin } = await import("./setup.mjs");
-		runAddLibraryBin(process.cwd());
-		break;
-	}
-	case "edit-package-json": {
-		const { runEditPackageJson } = await import("./setup.mjs");
-		runEditPackageJson(process.cwd());
-		break;
-	}
-	case "setup-github-actions": {
-		const { runSetupGithubActions } = await import("./setup.mjs");
-		runSetupGithubActions(process.cwd(), getMetaDir());
-		break;
+	} catch (err) {
+		if (isCliFailure(err)) {
+			console.error(err.message);
+			return err.exitCode;
+		}
+		throw err;
 	}
-	default:
-		console.log(USAGE);
-		process.exit(command ? 1 : 0);
+}
+if (process.argv[1] !== void 0 && import.meta.url === pathToFileURL(process.argv[1]).href) {
+	const exitCode = await main();
+	process.exit(exitCode);
 }
 
 //#endregion
-export {  };
+export { USAGE, main };

package/dist/display-CuCDLPP_.mjs

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

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { a as IntentProjectConfig, c as ScanResult, d as StalenessReport, i as IntentPackage, l as SkillEntry, n as FeedbackPayload, o as MetaFeedbackPayload, r as IntentConfig, s as MetaSkillName, t as AgentName, u as SkillStaleness } from "./types-BmnI8kFB.mjs";
-import { a as runEditPackageJson, i as runAddLibraryBin, n as EditPackageJsonResult, o as runSetupGithubActions, r as SetupGithubActionsResult, t as AddLibraryBinResult } from "./setup-CANkTz55.mjs";
+import { a as IntentProjectConfig, c as ScanResult, d as StalenessReport, i as IntentPackage, l as SkillEntry, n as FeedbackPayload, o as MetaFeedbackPayload, r as IntentConfig, s as MetaSkillName, t as AgentName, u as SkillStaleness } from "./types-ddLtccfV.mjs";
+import { c as runAddLibraryBin, f as runSetupGithubActions, i as SetupGithubActionsResult, n as EditPackageJsonResult, t as AddLibraryBinResult, u as runEditPackageJson } from "./setup-6m3IfxyO.mjs";
 
 //#region src/scanner.d.ts
 declare function scanForIntents(root?: string): Promise<ScanResult>;
@@ -13,11 +13,11 @@ declare function hasGhCli(): boolean;
 declare function resolveFrequency(root: string): string;
 declare function validatePayload(payload: unknown): {
   valid: boolean;
-  errors: string[];
+  errors: Array<string>;
 };
 declare function validateMetaPayload(payload: unknown): {
   valid: boolean;
-  errors: string[];
+  errors: Array<string>;
 };
 declare function metaToMarkdown(payload: MetaFeedbackPayload): string;
 declare function toMarkdown(payload: FeedbackPayload): string;
@@ -38,10 +38,22 @@ declare function submitMetaFeedback(payload: MetaFeedbackPayload, opts: {
 /**
  * Recursively find all SKILL.md files under a directory.
  */
-declare function findSkillFiles(dir: string): string[];
+declare function findSkillFiles(dir: string): Array<string>;
+/**
+ * Read dependencies and peerDependencies (and optionally devDependencies) from
+ * a parsed package.json object.
+ */
+declare function getDeps(pkgJson: Record<string, unknown>, includeDevDeps?: boolean): Array<string>;
+/**
+ * Resolve the directory of a dependency by name. First checks the top-level
+ * node_modules (hoisted layout — npm, yarn, bun), then resolves through the
+ * parent package's real path to handle pnpm's virtual store layout where
+ * transitive deps are siblings in the .pnpm virtual store node_modules.
+ */
+declare function resolveDepDir(depName: string, parentDir: string, parentName: string, nodeModulesDirs: string | Array<string>): string | null;
 /**
  * Parse YAML frontmatter from a file. Returns null if no frontmatter or on error.
  */
 declare function parseFrontmatter(filePath: string): Record<string, unknown> | null;
 //#endregion
-export { type AddLibraryBinResult, type AgentName, type EditPackageJsonResult, type FeedbackPayload, type IntentConfig, type IntentPackage, type IntentProjectConfig, type MetaFeedbackPayload, type MetaSkillName, type ScanResult, type SetupGithubActionsResult, type SkillEntry, type SkillStaleness, type StalenessReport, checkStaleness, containsSecrets, findSkillFiles, hasGhCli, metaToMarkdown, parseFrontmatter, resolveFrequency, runAddLibraryBin, runEditPackageJson, runSetupGithubActions, scanForIntents, submitFeedback, submitMetaFeedback, toMarkdown, validateMetaPayload, validatePayload };
+export { type AddLibraryBinResult, type AgentName, type EditPackageJsonResult, type FeedbackPayload, type IntentConfig, type IntentPackage, type IntentProjectConfig, type MetaFeedbackPayload, type MetaSkillName, type ScanResult, type SetupGithubActionsResult, type SkillEntry, type SkillStaleness, type StalenessReport, checkStaleness, containsSecrets, findSkillFiles, getDeps, hasGhCli, metaToMarkdown, parseFrontmatter, resolveDepDir, resolveFrequency, runAddLibraryBin, runEditPackageJson, runSetupGithubActions, scanForIntents, submitFeedback, submitMetaFeedback, toMarkdown, validateMetaPayload, validatePayload };

package/dist/index.mjs

@@ -1,7 +1,7 @@
-import { n as parseFrontmatter, t as findSkillFiles } from "./utils-DH3jY3CI.mjs";
-import { t as scanForIntents } from "./scanner-dIYdkHQ1.mjs";
-import { t as checkStaleness } from "./staleness-lP6B0O4z.mjs";
-import { n as runEditPackageJson, r as runSetupGithubActions, t as runAddLibraryBin } from "./setup-BYOg-Ii-.mjs";
+import { a as parseFrontmatter, n as findSkillFiles, o as resolveDepDir, r as getDeps } from "./utils-DY1eH2E_.mjs";
+import { t as scanForIntents } from "./scanner-f82qRq7h.mjs";
+import { t as checkStaleness } from "./staleness-D_ZiK4Tf.mjs";
+import { c as runSetupGithubActions, i as runAddLibraryBin, o as runEditPackageJson } from "./setup-CncHbQlb.mjs";
 import { readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { execFileSync, execSync } from "node:child_process";
@@ -31,17 +31,26 @@ function hasGhCli() {
 function getHomeConfigDir() {
 	return process.env.XDG_CONFIG_HOME ?? join(process.env.HOME ?? process.env.USERPROFILE ?? "", ".config");
 }
-function resolveFrequency(root) {
-	const userConfigPath = join(getHomeConfigDir(), "intent", "config.json");
-	try {
-		const userCfg = JSON.parse(readFileSync(userConfigPath, "utf8"));
-		if (userCfg.feedback?.frequency) return userCfg.feedback.frequency;
-	} catch {}
-	const projectConfigPath = join(root, "intent.config.json");
+function parseFrequency(value) {
+	if (value === "always" || value === "never") return value;
+	if (typeof value !== "string") return null;
+	const match = /^every-(\d+)$/.exec(value);
+	if (!match) return null;
+	const count = Number(match[1]);
+	return Number.isInteger(count) && count > 0 ? `every-${count}` : null;
+}
+function readFrequency(filePath) {
 	try {
-		const projCfg = JSON.parse(readFileSync(projectConfigPath, "utf8"));
-		if (projCfg.feedback?.frequency) return projCfg.feedback.frequency;
-	} catch {}
+		return parseFrequency(JSON.parse(readFileSync(filePath, "utf8")).feedback?.frequency);
+	} catch {
+		return null;
+	}
+}
+function resolveFrequency(root) {
+	const userFrequency = readFrequency(join(getHomeConfigDir(), "intent", "config.json"));
+	if (userFrequency) return userFrequency;
+	const projectFrequency = readFrequency(join(root, "intent.config.json"));
+	if (projectFrequency) return projectFrequency;
 	return "every-5";
 }
 const REQUIRED_FIELDS = [
@@ -102,6 +111,18 @@ const VALID_QUALITY_RATINGS = [
 	"mixed",
 	"bad"
 ];
+const VALID_INTERVIEW_QUALITY_RATINGS = [
+	"good",
+	"mixed",
+	"bad",
+	"skipped"
+];
+const VALID_FAILURE_MODE_QUALITY_RATINGS = [
+	"good",
+	"mixed",
+	"bad",
+	"not-applicable"
+];
 function validateMetaPayload(payload) {
 	const errors = [];
 	if (!payload || typeof payload !== "object") return {
@@ -114,6 +135,8 @@ function validateMetaPayload(payload) {
 	if (obj.agentUsed && !VALID_AGENTS.includes(obj.agentUsed)) errors.push(`agentUsed must be one of: ${VALID_AGENTS.join(", ")}`);
 	if (obj.artifactQuality && !VALID_QUALITY_RATINGS.includes(obj.artifactQuality)) errors.push("artifactQuality must be one of: good, mixed, bad");
 	if (obj.userRating && !VALID_QUALITY_RATINGS.includes(obj.userRating)) errors.push("userRating must be one of: good, mixed, bad");
+	if (obj.interviewQuality && !VALID_INTERVIEW_QUALITY_RATINGS.includes(obj.interviewQuality)) errors.push("interviewQuality must be one of: good, mixed, bad, skipped");
+	if (obj.failureModeQuality && !VALID_FAILURE_MODE_QUALITY_RATINGS.includes(obj.failureModeQuality)) errors.push("failureModeQuality must be one of: good, mixed, bad, not-applicable");
 	if (containsSecrets(Object.values(obj).filter((v) => typeof v === "string").join("\n"))) errors.push("Payload appears to contain secrets or tokens — submission rejected");
 	return {
 		valid: errors.length === 0,
@@ -246,4 +269,4 @@ function submitMetaFeedback(payload, opts) {
 }
 
 //#endregion
-export { checkStaleness, containsSecrets, findSkillFiles, hasGhCli, metaToMarkdown, parseFrontmatter, resolveFrequency, runAddLibraryBin, runEditPackageJson, runSetupGithubActions, scanForIntents, submitFeedback, submitMetaFeedback, toMarkdown, validateMetaPayload, validatePayload };
+export { checkStaleness, containsSecrets, findSkillFiles, getDeps, hasGhCli, metaToMarkdown, parseFrontmatter, resolveDepDir, resolveFrequency, runAddLibraryBin, runEditPackageJson, runSetupGithubActions, scanForIntents, submitFeedback, submitMetaFeedback, toMarkdown, validateMetaPayload, validatePayload };