@tanstack/intent 0.0.1 → 0.0.3

package/README.md

@@ -50,16 +50,16 @@ npx intent setup
 
 ## CLI Commands
 
-| Command                  | Description                                      |
-| ------------------------ | ------------------------------------------------ |
-| `intent init`            | Inject intent discovery into agent config files  |
-| `intent list [--json]`   | Discover intent-enabled packages                 |
-| `intent meta`            | List meta-skills for library maintainers         |
-| `intent scaffold`        | Print the guided skill generation prompt         |
-| `intent validate [dir]`  | Validate SKILL.md files                          |
-| `intent setup`           | Copy CI/Oz workflow templates                    |
-| `intent stale [--json]`  | Check skills for version drift                   |
-| `intent feedback`        | Submit skill feedback                            |
+| Command                 | Description                                     |
+| ----------------------- | ----------------------------------------------- |
+| `intent init`           | Inject intent discovery into agent config files |
+| `intent list [--json]`  | Discover intent-enabled packages                |
+| `intent meta`           | List meta-skills for library maintainers        |
+| `intent scaffold`       | Print the guided skill generation prompt        |
+| `intent validate [dir]` | Validate SKILL.md files                         |
+| `intent setup`          | Copy CI/Oz workflow templates                   |
+| `intent stale [--json]` | Check skills for version drift                  |
+| `intent feedback`       | Submit skill feedback                           |
 
 ## License
 

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { n as parseFrontmatter, t as findSkillFiles } from "./utils-DjkEPBxu.mjs";
-import { t as scanForIntents } from "./scanner-CpsJAHXT.mjs";
+import { n as parseFrontmatter, t as findSkillFiles } from "./utils-DH3jY3CI.mjs";
+import { t as scanForIntents } from "./scanner-BwCyu1Jq.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { dirname, join, relative, sep } from "node:path";
 import { parse } from "yaml";
@@ -12,6 +12,55 @@ import { fileURLToPath } from "node:url";
 function getMetaDir() {
 	return join(dirname(fileURLToPath(import.meta.url)), "..", "meta");
 }
+function padColumn(text, width) {
+	return text.length >= width ? text + "  " : text.padEnd(width);
+}
+function printTable(headers, rows) {
+	const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? "").length)) + 2);
+	const headerLine = headers.map((h, i) => padColumn(h, widths[i])).join("");
+	const separator = widths.map((w) => "─".repeat(w)).join("");
+	console.log(headerLine);
+	console.log(separator);
+	for (const row of rows) console.log(row.map((cell, i) => padColumn(cell, widths[i])).join(""));
+}
+function printSkillTree(skills, opts) {
+	const roots = [];
+	const children = /* @__PURE__ */ new Map();
+	for (const skill of skills) {
+		const slashIdx = skill.name.indexOf("/");
+		if (slashIdx === -1) roots.push(skill.name);
+		else {
+			const parent = skill.name.slice(0, slashIdx);
+			if (!children.has(parent)) children.set(parent, []);
+			children.get(parent).push(skill);
+		}
+	}
+	if (roots.length === 0) {
+		for (const skill of skills) if (!roots.includes(skill.name)) roots.push(skill.name);
+	}
+	for (const rootName of roots) {
+		const rootSkill = skills.find((s) => s.name === rootName);
+		if (!rootSkill) continue;
+		printSkillLine(rootName, rootSkill, 4, opts);
+		for (const sub of children.get(rootName) ?? []) printSkillLine(sub.name.slice(sub.name.indexOf("/") + 1), sub, 6, opts);
+	}
+}
+function printSkillLine(displayName, skill, indent, opts) {
+	const nameStr = " ".repeat(indent) + displayName;
+	const padding = " ".repeat(Math.max(2, opts.nameWidth - nameStr.length));
+	const typeCol = opts.showTypes ? (skill.type ? `[${skill.type}]` : "").padEnd(14) : "";
+	console.log(`${nameStr}${padding}${typeCol}${skill.description}`);
+}
+function computeSkillNameWidth(allPackageSkills) {
+	let max = 0;
+	for (const skills of allPackageSkills) for (const s of skills) {
+		const slashIdx = s.name.indexOf("/");
+		const displayName = slashIdx === -1 ? s.name : s.name.slice(slashIdx + 1);
+		const indent = slashIdx === -1 ? 4 : 6;
+		max = Math.max(max, indent + displayName.length);
+	}
+	return max + 2;
+}
 async function cmdList(args) {
 	const jsonOutput = args.includes("--json");
 	let result;
@@ -33,14 +82,28 @@ async function cmdList(args) {
 		}
 		return;
 	}
-	console.log(`Intent-enabled packages (${result.packages.length} found):\n`);
+	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`);
+	printTable([
+		"PACKAGE",
+		"VERSION",
+		"SKILLS",
+		"REQUIRES"
+	], result.packages.map((pkg) => [
+		pkg.name,
+		pkg.version,
+		String(pkg.skills.length),
+		pkg.intent.requires?.join(", ") || "–"
+	]));
+	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`);
 	for (const pkg of result.packages) {
-		const reqStr = pkg.intent.requires?.length ? `  (requires: ${pkg.intent.requires.join(", ")})` : "";
-		console.log(`${pkg.name} v${pkg.version}${reqStr}`);
-		for (const skill of pkg.skills) {
-			const desc = skill.description ? `  ${skill.description}` : "";
-			console.log(`  ${skill.name.padEnd(32)}${desc}`);
-		}
+		console.log(`  ${pkg.name}`);
+		printSkillTree(pkg.skills, {
+			nameWidth,
+			showTypes
+		});
 		console.log();
 	}
 	if (result.warnings.length > 0) {
@@ -276,8 +339,8 @@ switch (command) {
 		cmdScaffold();
 		break;
 	case "stale": {
-		const { checkStaleness } = await import("./staleness-DyhsrqQ5.mjs");
-		const { scanForIntents: scanStale } = await import("./scanner-BuWPDJ4P.mjs");
+		const { checkStaleness } = await import("./staleness-B5gUj7FR.mjs");
+		const { scanForIntents: scanStale } = await import("./scanner-fAWJUn6Q.mjs");
 		let staleResult;
 		try {
 			staleResult = await scanStale();

package/dist/index.mjs

@@ -1,6 +1,6 @@
-import { n as parseFrontmatter, t as findSkillFiles } from "./utils-DjkEPBxu.mjs";
-import { t as scanForIntents } from "./scanner-CpsJAHXT.mjs";
-import { t as checkStaleness } from "./staleness-CnomT9Hm.mjs";
+import { n as parseFrontmatter, t as findSkillFiles } from "./utils-DH3jY3CI.mjs";
+import { t as scanForIntents } from "./scanner-BwCyu1Jq.mjs";
+import { t as checkStaleness } from "./staleness-lP6B0O4z.mjs";
 import { c as toMarkdown, i as resolveFrequency, l as validateMetaPayload, n as hasGhCli, o as submitFeedback, r as metaToMarkdown, s as submitMetaFeedback, t as containsSecrets, u as validatePayload } from "./feedback-DKreHfB1.mjs";
 import { a as runInit, i as readProjectConfig, n as hasIntentBlock, o as writeProjectConfig, r as injectIntentBlock, t as detectAgentConfigs } from "./init-DNxmjQfU.mjs";
 import { t as runSetup } from "./setup-CNGz26qL.mjs";

package/dist/intent-library.mjs

@@ -1,8 +1,6 @@
 #!/usr/bin/env node
-import "./utils-DjkEPBxu.mjs";
-import { t as scanLibrary } from "./library-scanner-BrznE00j.mjs";
-import { spawnSync } from "node:child_process";
-import { release } from "node:os";
+import "./utils-DH3jY3CI.mjs";
+import { t as scanLibrary } from "./library-scanner-D0aP7is_.mjs";
 
 //#region src/intent-library.ts
 async function cmdList() {
@@ -37,18 +35,7 @@ async function cmdList() {
 	}
 }
 function cmdInstall() {
-	function tryCopyToClipboard(text) {
-		const platform = process.platform;
-		const isWsl = platform === "linux" && (Boolean(process.env.WSL_DISTRO_NAME) || Boolean(process.env.WSL_INTEROP) || release().toLowerCase().includes("microsoft"));
-		const tryCommand = (command$1, args = []) => {
-			return spawnSync(command$1, args, { input: text }).status === 0;
-		};
-		if (platform === "darwin") return tryCommand("pbcopy");
-		if (platform === "win32") return tryCommand("clip");
-		if (isWsl) return tryCommand("clip.exe");
-		return tryCommand("wl-copy") || tryCommand("xclip", ["-selection", "clipboard"]) || tryCommand("xsel", ["--clipboard", "--input"]);
-	}
-	const prompt = `You are an AI assistant helping a developer set up skill-to-task mappings for their project.
+	console.log(`You are an AI assistant helping a developer set up skill-to-task mappings for their project.
 
 Follow these steps in order:
 
@@ -93,18 +80,14 @@ skills:
    - 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("🚀 Intent Install");
-	console.log("✨ Copy the prompt below into your AI agent:\n");
-	console.log(prompt);
-	if (tryCopyToClipboard(prompt)) console.log("\n✅ Copied prompt to clipboard");
-	else console.log("\n⚠ Tip: Manually copy the prompt above into your agent");
+   - Preserve all content outside the block tags unchanged`);
 }
 const USAGE = `TanStack Intent
 
 Usage:
   intent list        List all available skills from this library and its dependencies
-  intent install     Set up skill-to-task mappings in your agent config`;
+  intent install     Print a skill that guides your coding agent to scan the project
+                     and set up skill-to-task mappings in your agent config`;
 const command = process.argv[2];
 switch (command) {
 	case "list":

package/dist/{library-scanner-BrznE00j.mjs → library-scanner-D0aP7is_.mjs}

@@ -1,4 +1,4 @@
-import { n as parseFrontmatter } from "./utils-DjkEPBxu.mjs";
+import { n as parseFrontmatter } from "./utils-DH3jY3CI.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { dirname, join, relative, sep } from "node:path";
 
@@ -37,7 +37,10 @@ function discoverSkills(skillsDir) {
 	function walk(dir) {
 		let entries;
 		try {
-			entries = readdirSync(dir, { withFileTypes: true });
+			entries = readdirSync(dir, {
+				withFileTypes: true,
+				encoding: "utf8"
+			});
 		} catch {
 			return;
 		}

package/dist/library-scanner.mjs

@@ -1,4 +1,4 @@
-import "./utils-DjkEPBxu.mjs";
-import { t as scanLibrary } from "./library-scanner-BrznE00j.mjs";
+import "./utils-DH3jY3CI.mjs";
+import { t as scanLibrary } from "./library-scanner-D0aP7is_.mjs";
 
 export { scanLibrary };

package/dist/{scanner-CpsJAHXT.mjs → scanner-BwCyu1Jq.mjs}

@@ -1,4 +1,4 @@
-import { n as parseFrontmatter } from "./utils-DjkEPBxu.mjs";
+import { n as parseFrontmatter } from "./utils-DH3jY3CI.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join, relative, sep } from "node:path";
 
@@ -12,7 +12,7 @@ function detectPackageManager(root) {
 	if (existsSync(join(root, "package-lock.json"))) return "npm";
 	return "unknown";
 }
-function validateIntentField(pkgName, intent) {
+function validateIntentField(_pkgName, intent) {
 	if (!intent || typeof intent !== "object") return null;
 	const pb = intent;
 	if (pb.version !== 1) return null;
@@ -26,12 +26,15 @@ function validateIntentField(pkgName, intent) {
 		requires
 	};
 }
-function discoverSkills(skillsDir, baseName) {
+function discoverSkills(skillsDir, _baseName) {
 	const skills = [];
 	function walk(dir) {
 		let entries;
 		try {
-			entries = readdirSync(dir, { withFileTypes: true });
+			entries = readdirSync(dir, {
+				withFileTypes: true,
+				encoding: "utf8"
+			});
 		} catch {
 			return;
 		}
@@ -86,7 +89,10 @@ async function scanForIntents(root) {
 	const packageDirs = [];
 	let topEntries;
 	try {
-		topEntries = readdirSync(nodeModulesDir, { withFileTypes: true });
+		topEntries = readdirSync(nodeModulesDir, {
+			withFileTypes: true,
+			encoding: "utf8"
+		});
 	} catch {
 		return {
 			packageManager,
@@ -100,7 +106,10 @@ async function scanForIntents(root) {
 		if (entry.name.startsWith("@")) {
 			let scopedEntries;
 			try {
-				scopedEntries = readdirSync(dirPath, { withFileTypes: true });
+				scopedEntries = readdirSync(dirPath, {
+					withFileTypes: true,
+					encoding: "utf8"
+				});
 			} catch {
 				continue;
 			}

package/dist/scanner-fAWJUn6Q.mjs

@@ -0,0 +1,4 @@
+import "./utils-DH3jY3CI.mjs";
+import { t as scanForIntents } from "./scanner-BwCyu1Jq.mjs";
+
+export { scanForIntents };

package/dist/staleness-B5gUj7FR.mjs

@@ -0,0 +1,4 @@
+import "./utils-DH3jY3CI.mjs";
+import { t as checkStaleness } from "./staleness-lP6B0O4z.mjs";
+
+export { checkStaleness };

package/dist/{staleness-CnomT9Hm.mjs → staleness-lP6B0O4z.mjs}

@@ -1,4 +1,4 @@
-import { n as parseFrontmatter, t as findSkillFiles } from "./utils-DjkEPBxu.mjs";
+import { n as parseFrontmatter, t as findSkillFiles } from "./utils-DH3jY3CI.mjs";
 import { readFileSync } from "node:fs";
 import { join, relative, sep } from "node:path";
 

package/dist/{utils-DjkEPBxu.mjs → utils-DH3jY3CI.mjs}

@@ -27,7 +27,7 @@ function parseFrontmatter(filePath) {
 		return null;
 	}
 	const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-	if (!match) return null;
+	if (!match?.[1]) return null;
 	try {
 		return parse(match[1]);
 	} catch {

package/meta/domain-discovery/SKILL.md

@@ -64,7 +64,7 @@ Log (but do not group yet):
 - What the library does in one sentence
 - The core abstractions a developer interacts with
 - Which frameworks it supports
-- Any existing skill files, agent configs, or playbooks
+- Any existing skill files, agent configs, or intents
 - Whether the library is a monorepo and which packages matter
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/intent",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Ship compositional knowledge for AI coding agents alongside your npm packages",
   "license": "MIT",
   "type": "module",
@@ -33,6 +33,7 @@
   },
   "scripts": {
     "build": "tsdown src/index.ts src/cli.ts src/setup.ts src/intent-library.ts src/library-scanner.ts --format esm --dts",
-    "test:lib": "vitest run"
+    "test:lib": "vitest run",
+    "test:types": "tsc --noEmit"
   }
 }

package/dist/scanner-BuWPDJ4P.mjs

@@ -1,4 +0,0 @@
-import "./utils-DjkEPBxu.mjs";
-import { t as scanForIntents } from "./scanner-CpsJAHXT.mjs";
-
-export { scanForIntents };

package/dist/staleness-DyhsrqQ5.mjs

@@ -1,4 +0,0 @@
-import "./utils-DjkEPBxu.mjs";
-import { t as checkStaleness } from "./staleness-CnomT9Hm.mjs";
-
-export { checkStaleness };