@tanstack/intent 0.0.14 → 0.0.20

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 { d as runEditPackageJson, i as SetupGithubActionsResult, l as runAddLibraryBin, n as EditPackageJsonResult, p as runSetupGithubActions, t as AddLibraryBinResult } from "./setup-B-zdCBu4.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,19 +38,18 @@ 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): string[];
+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.
+ * Resolve the directory of a dependency by name. Tries createRequire first
+ * (handles pnpm symlinks), then falls back to walking up node_modules
+ * directories (handles packages with export maps that block ./package.json).
  */
-declare function resolveDepDir(depName: string, parentDir: string, parentName: string, nodeModulesDir: string): string | null;
+declare function resolveDepDir(depName: string, parentDir: string): string | null;
 /**
  * Parse YAML frontmatter from a file. Returns null if no frontmatter or on error.
  */

package/dist/index.mjs

@@ -1,7 +1,7 @@
-import { i as resolveDepDir, n as getDeps, r as parseFrontmatter, t as findSkillFiles } from "./utils-CDJzAdjD.mjs";
-import { t as scanForIntents } from "./scanner-CY40iozO.mjs";
-import { t as checkStaleness } from "./staleness-DJfMKH62.mjs";
-import { n as runEditPackageJson, r as runSetupGithubActions, t as runAddLibraryBin } from "./setup-Nif1-nhS.mjs";
+import { a as parseFrontmatter, n as findSkillFiles, o as resolveDepDir, r as getDeps } from "./utils-BfjM1mQe.mjs";
+import { a as runAddLibraryBin, l as runSetupGithubActions, s as runEditPackageJson } from "./setup-mGV2dZrq.mjs";
+import { t as scanForIntents } from "./scanner-DVepyEwz.mjs";
+import { t as checkStaleness } from "./staleness-DZKvsLVq.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,

package/dist/install-prompt-C0M-U3WZ.mjs

@@ -0,0 +1,59 @@
+//#region src/install-prompt.ts
+const INSTALL_PROMPT = `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 (AGENTS.md, CLAUDE.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, keep that file as the source of truth,
+     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: \`npx @tanstack/intent@latest list\`
+   This outputs each skill's name, description, full path, and whether it was found in
+   project-local node_modules or accessible global node_modules.
+   This works best in Node-compatible environments (npm, pnpm, Bun, or Deno npm interop
+   with node_modules enabled).
+
+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."
+   Also ask: "I'll default to AGENTS.md unless you want another supported config file.
+   Do you have a preference?"
+
+4. WRITE THE MAPPINGS BLOCK
+   Once you have the full set of mappings, write or update the agent config file.
+   - If you found an existing intent-skills block, update that file in place.
+   - Otherwise prefer AGENTS.md by default, unless the user asked for another supported file.
+
+   Use 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 \`npx @tanstack/intent@latest 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
+   - If the user is on Deno, note that this setup is best-effort today and relies on npm interop`;
+
+//#endregion
+export { INSTALL_PROMPT as t };

package/dist/intent-library.mjs

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
-import "./utils-CDJzAdjD.mjs";
-import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-D_XzuGnu.mjs";
-import { t as scanLibrary } from "./library-scanner-B1tmOzwf.mjs";
+import "./utils-BfjM1mQe.mjs";
+import { t as INSTALL_PROMPT } from "./install-prompt-C0M-U3WZ.mjs";
+import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-DhsUxNJW.mjs";
+import { t as scanLibrary } from "./library-scanner-DBOEhfm8.mjs";
 
 //#region src/intent-library.ts
 async function cmdList() {
@@ -52,52 +53,7 @@ async function cmdList() {
 	}
 }
 function cmdInstall() {
-	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`);
+	console.log(INSTALL_PROMPT);
 }
 const USAGE = `TanStack Intent
 

package/dist/{library-scanner-B1tmOzwf.mjs → library-scanner-DBOEhfm8.mjs}

@@ -1,4 +1,4 @@
-import { i as resolveDepDir, n as getDeps, r as parseFrontmatter } from "./utils-CDJzAdjD.mjs";
+import { a as parseFrontmatter, o as resolveDepDir, r as getDeps } from "./utils-BfjM1mQe.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { dirname, join, relative, sep } from "node:path";
 
@@ -12,7 +12,7 @@ function readPkgJson(dir) {
 }
 function findHomeDir(scriptPath) {
 	let dir = dirname(scriptPath);
-	while (true) {
+	for (;;) {
 		if (existsSync(join(dir, "package.json"))) return dir;
 		const parent = dirname(dir);
 		if (parent === dir) return null;
@@ -57,8 +57,7 @@ function discoverSkills(skillsDir) {
 	walk(skillsDir);
 	return skills;
 }
-async function scanLibrary(scriptPath, projectRoot) {
-	const nodeModulesDir = join(projectRoot ?? process.cwd(), "node_modules");
+async function scanLibrary(scriptPath, _projectRoot) {
 	const packages = [];
 	const warnings = [];
 	const visited = /* @__PURE__ */ new Set();
@@ -89,7 +88,7 @@ async function scanLibrary(scriptPath, projectRoot) {
 			skills: existsSync(skillsDir) ? discoverSkills(skillsDir) : []
 		});
 		for (const depName of getDeps(pkg)) {
-			const depDir = resolveDepDir(depName, dir, name, nodeModulesDir);
+			const depDir = resolveDepDir(depName, dir);
 			if (!depDir) continue;
 			const depPkg = readPkgJson(depDir);
 			if (depPkg && hasIntentBin(depPkg)) processPackage(depName, depDir);

package/dist/library-scanner.d.mts

@@ -1,16 +1,16 @@
-import { l as SkillEntry } from "./types-BmnI8kFB.mjs";
+import { l as SkillEntry } from "./types-ddLtccfV.mjs";
 
 //#region src/library-scanner.d.ts
 interface LibraryPackage {
   name: string;
   version: string;
   description: string;
-  skills: SkillEntry[];
+  skills: Array<SkillEntry>;
 }
 interface LibraryScanResult {
-  packages: LibraryPackage[];
-  warnings: string[];
+  packages: Array<LibraryPackage>;
+  warnings: Array<string>;
 }
-declare function scanLibrary(scriptPath: string, projectRoot?: string): Promise<LibraryScanResult>;
+declare function scanLibrary(scriptPath: string, _projectRoot?: string): Promise<LibraryScanResult>;
 //#endregion
 export { LibraryPackage, LibraryScanResult, scanLibrary };

package/dist/library-scanner.mjs

@@ -1,4 +1,4 @@
-import "./utils-CDJzAdjD.mjs";
-import { t as scanLibrary } from "./library-scanner-B1tmOzwf.mjs";
+import "./utils-BfjM1mQe.mjs";
+import { t as scanLibrary } from "./library-scanner-DBOEhfm8.mjs";
 
 export { scanLibrary };

package/dist/scanner-BHPl60jH.mjs

@@ -0,0 +1,5 @@
+import "./utils-BfjM1mQe.mjs";
+import "./setup-mGV2dZrq.mjs";
+import { t as scanForIntents } from "./scanner-DVepyEwz.mjs";
+
+export { scanForIntents };